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protocol. RTP has been widely used in the Multicast Backbone (MBone), a virtual network 
that has become a shared worldwide medium for Internet multicast communications. 

This work presents the design patterns, architecture and implementation of an RTP 
monitor application using the Java Media Framework (JMF), a new Java Application 
Programming Interface (API) for multimedia support. An RTP monitor is an application 
that receives packets from all participants in a multicast session in order to estimate the 
quality of service for distribution monitoring, fault diagnosis and both short and long-term 
statistics. 

This new RTP monitor is available as a component of the Virtual Reality Transfer 
Protocol (vrtp), a protocol being developed to support large-scale virtual environments 
(LSVEs) over the Internet. Initial test results are satisfactory for audio and video streams, as 
well as prototype RTP-compliant Distributed Interactive Simulation (DIS) protocol streams. 
Future work includes automated monitoring across WANs and standardizing structured data 
formats to comply with Management Information Base (MIB) requirements using 


Extensible Markup Language (XML) target set definitions. 
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I. INTRODUCTION 


A. BACKGROUND 


The Multicast Backbone (MBone) is a virtual network that has been in operation 
since 1992. It was initially used to multicast audio and video from meetings of the 
Internet Engineering Task Force, but nowadays it has become a shared worldwide 
medium with many diverse channels for Internet multicast communications (Macedonia, 
et al., 94). 

The Real-time Transport Protocol (RTP) was developed to support time-based 
media, such as audio and video, over multicast-capable networks (Schulzrinne, et al., 99). 
RTP is the basic packet header format for MBone application streams. Using RTP, a 
multicast session between several participants can be established, making possible the 
correct synchronization of the exchanged media and the feedback of each participant 
about the quality of reception. The RTP Control Protocol (RTCP) performs the feedback 
and control mechanisms of RTP. 

Java Media Framework (JMF) is a new Java Application Programming Interface 
(API) developed by Sun and other companies to allow Java programmers use multimedia 
features in applications and applets (Sun, 99). JMF supports RTP transmission and 
reception of audio and video streams. This thesis examines network-monitoring issues 


relevant to RTP through implementation and testing of a JMF application. 


B. MOTIVATION 


Since its inception, RTP has been mostly used in audio and video conferences. 


However, a diverse set of multicast applications can take benefit of RTP mechanisms for 


synchronization, such as exchanging simulation data over a wide-area network (WAN). 
RTP is particular important because it is used by backbone routers to support Quality of 
Service (QoS) related performance optimization. 

The Virtual Reality Transfer Protocol (vrtp) is developed to provide client, server, 
multicast streaming and network-monitoring capabilities in support of internetworked 3D 
graphics and large-scale virtual environments (LSVEs) (Brutzman, 99). RTP is an 
integral part of the vrtp architecture, used in both the streaming and monitoring 
components. 

JMF is a possible solution for the implementation of the RTP protocol in vrtp. 
JMF is a free package and is an approved extension of the Java language application 


programming interface (API). 


C. OBJECTIVES 


The goal of this thesis 1s the implementation of a monitor application for the Real- 
time Transport Protocol (RTP) using Java Media Framework (JMF). An RTP monitor 18 
an application that receives packets sent by all participants in order to estimate the quality 
of service for distribution monitoring, data recording, statistics analysis and fault 
diagnosis (Schulzrinne, et al., 99). The emphasis is in both short-term and long-term 
statistics by having recording capabilities for future analysis. As a result of this work, an 


example set of classes for monitoring RTP sessions can be provided to vrtp applications. 


D. THESIS ORGANIZATION 


The remaining chapters of this thesis are organized as follows. Chapter II 
describes work related to RTP monitoring. Chapter III presents the RTP protocol 
functionality and packet formats. Chapter IV provides an overview of the JMF 
architecture with emphasis on the RTP classes. Chapter V describes the design and 
implementation of the RTP monitor application, and the interdependency between the 
RTP Monitor and JMF classes. Chapter VI contains a study of compatibility between 
JMF statistics and the proposed RTP Management Information Base (MIB) (Baugher, et 
al., 99). Chapter VII contains the experimental results achieved and problems observed. 
Finally, Chapter VIII presents conclusions and provides recommendations for future 


work. 
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Il. RELATED WORK 


A. INTRODUCTION 


This chapter presents some related work in the area of RTP monitoring. RTP 
monitoring is closely related to the RTCP protocol, but some applications discussed here 
combine RTCP data with multicast route tracing, improving the monitoring quality. 
Applications are considered in into two categories: media conference applications with 
monitoring features, and dedicated monitors. This chapter also contains pertinent 


information about the vrtp protocol and the Internet 2 Surveyor project. 


B. RTP MONITORING IN MEDIA CONFERENCE APPLICATIONS 


Most conference applications used in MBone can display some sort of RTP 
monitoring data. As the emphasis of these applications is media presentation and stream 
quality assessment, the statistical data is usually not enough for network administration or 
diagnostic purposes. The RTP statistics features of some conference applications are 


described here. 


1? Video Conferencing Tool (VIC) 


VIC is a video conferencing application developed by the Network Research 
Group at the Lawrence Berkeley National Laboratory (LBNL) in collaboration with the 
University of California, Berkeley (UCB). The software was improved by University 
College of London (UCL). The latest version is 2.8ucl4. (UCL, 99) 
The RTP statistics window of each VIC video stream consists of a grid with 


three columns (Figure 2.1). The first column, EWA (Exponentially Weighted Average), is 


the change since the last sampling period (i.e. change over the last second); the middle 
column, Delta, is a smoothed version of the EWA; and the last column, Total, is the 
accumulated value since start-up. Clicking any of the buttons in the left column opens a 
Plot Window displaying the statistics for that parameter graphically. (UCL, 99) 


Figure 2.1 contains example RTP statistics for video VIC streams. 


vic: Capitol Connection 
> Capitol Connection - GMU TY x —————— 
é Capitol Lon —~ — oJ OLX! Capitol Connection 


RTP Statistics 
Copyright (c} George Mason Uni 
14tis 148 kb/s (14% 


VIC v2. 8ucl4 Menu | Help | Quit | 


vic:plot window 


i 


range Oto 20, 2/div Dismiss | 
Dismiss | 





Figure 2.1 RTP Statistics in VIC showing video stream, 
available statistics (right side) and a 10-second trace of missing- 
packet data (lower-left corner). Recorded July 1999. 


Pas Robust Audio Tool (RAT) 


RAT is an audio conference application developed by UCL. The latest version is 
4.0.3 (UCL, 99). Figure 2.2 shows an example of RTP statistics available in RAT. Each 


set of statistics is related to one receiving audio stream. 


Participant Capitol Connection [ifa] 


Category: Reception ao | 
[Audio encoding: GSM-8kK-Mono 
[Packet duration (ms): 20 


[Playout delay (ms): DZ 
[Arrival jitter (ms): 22 





Loss from me (%): 101 
Loss to me (%): 8 
[Packets received: 1643 
Packets lost: 703 


[Packets misordered: 252 
[Packets duplicated: 0 
[Units dropped (jitter): 0 





Dismiss | 


Figure 2.2 RTP Statistics in RAT. 


DEDICATED MONITORS 


ie Mtrace 


Mtrace allows the user trace a route from a receiver to a source working 
backwards using a particular multicast address. It runs only on Unix systems. If 
either the receiver or the source 1s not participating in a multicast on the specified 
address then mtrace may not work. Vic and vat can automatically launch the 
mtrace utility. Mtrace 1s included in the mrouted distribution and can be 
downloaded at the following site: 


http://www.cs.unc.edu/~wangx/MBONE/mbonetoolarchive.html#mtrace 


he Session Directory (SDR) Monitor 


SDR Monitor, short for SDR Global Session Monitoring Effort, 1s an 
effort to track, manage, and present information about the availability of world- 
wide multicast sessions using the SDR tool (Sarac, 99). SDR 1s a session directory 
tool designed to allow the advertisement and joining of multicast conferences on 
the MBone (UCL, 99). 

The basic idea of the SDR Monitor is that the SDR application can 
periodically send an an email to the project control containing all the session 
announcements that are being received at the user site. All data collected is made 
available in world-wide-web page, using a tabulated form that conveys 


information about the session reachability. 


a5 Rtpmon 


Rtpmon is a third-party RTP monitor written in C++ by the Plateau Multimedia 
Research Group at Berkeley. Version 1.0 was the last release in 1996. It works only on 
Unix systems. Both source code and binaries are available. It is possible to integrate 
rtpmon with vic and/or vat by modifying the files .vic.tcl and/or .vat.tcl. This will add a 
monitor button to vic and vat that when pressed will launch rtpmon. (Agarwal, 97) 

Rtpmon provides a number of useful capabilities for sorting, filtering and 
displaying the statistics generated in an RTP session (David, 96). Figure 2.3 shows an 
example of the rtpmon Graphical User Interface (GUI). It displays RTCP statistics in a 
table with senders listed along the top and listeners along the left. Each entry in the table 
corresponds to the data obtained about a single sender-receiver pair. The program listens 
to RTCP messages on a multicast address specified at startup time; there is no provision 
for displaying data from multiple sessions. Information about each participant can be 
obtained by clicking the participant's name in the table display; doing so brings up a 
window with the session description items provided in the member's RTCP reports. The 
information window also contains a button, which spawns mtrace for detailed single- 
sender-receiver multicast routing data. Rtpmon can also display a brief history of the 
statistics from each sender-receiver pair. Clicking on a data element in the main table 


brings up charts for each of the statistics values that rtpmon tracks. 


Robert Elz (Melbourne) 
|Don Brutzman 
Hikan Lennestil (Erisoft AB, Lulel, Sweden) 


srcid: 294851760 
Chris Wiener (CR Laws ) address: 164.67.182.253 

| email: mvn@library.ucla.edu 
| tool: vie-2.7a32 

-| Last control packet: 14:35:22 


Display parameter 


# Loss Percentage 
Threshold: fi 
wv Jitter 


sorting 
Sort receivers by: 
* Maximum Loss 


w Average Loss 
w IP address 


~y Sender: [Two Steves s+ 
™ Autosort interval: [5 secs 


Session 


Dest: 224.2.204.138 Port: 60856 


J Key: | 
Global Stats | 


Dismiss 





Figure 2.3 Rtpmon graphical user interface (GUI). 
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4. MultiMON 


MultiMON is a client/server monitor that collects, organizes and displays all the 
IP multicast traffic that is detected at the location of a server (Robinson, et al, 96). It was 
developed by the Communications Research Center at Ottawa. Last release was version 
2.0 in July 1998. It can be downloaded at ftp://debra.dgbt.doc.ca/pub/mbone/multimon/. 

MultiMON is a general-purpose multicast monitoring tool. It 1s intended to 
monitor multicast traffic on local-area network (LAN) segments and assist a network 
administrator in managing the traffic on an Intranet. The client main window displays the 
total bandwidth occupied by the multicast traffic and gives a graphical breakdown of the 


traffic by application type, as shown in Figure 2.4. 





= MultiMON Multicast Monitor 
File Options Help 


& Multicast types on localhost 


10 
current: 416.1 kbis 


y vy 28K 
v 64K 
vy 128K 
vy 256 K 
@ 512K 
vy 2048 K 
~, 10000 K 





! af 
Figure 2.4 MultiMON client window (Robinson, et al, 96). 





The software includes an RTCP monitoring and recording tool (MERCInari) that 
allows an analysis of the RTCP data for QoS management. A session can be recorded for 
later analysis. MultiMON is written in tk/tcl, but needs tcpdump, xplot, the distributed 
processing additions and the object-oriented additions to tk/tcl. It runs in Sun 


workstations, but it can be ported to other platforms including Windows 95/98 and NT. 


>: MHealth 


MHealth, the Multicast Health Monitor, is a graphical multicast monitoring tool 
(Makofske, et al., 99). By using a combination of application-level protocol data for 
participant information and a multicast route-tracing tool for topology information, 
MHealth is able to present a multicast tree's topology and information about the quality 
of received data. Figure 2.5 contains a screenshot of MHealth. 

MHealth also provides data-logging functionality for the purpose of isolating and 
analyzing network faults. Logs can be analyzed to provide information such as receiver 
lists over time, route histories and changes, as well as the location, duration, and 
frequency of packet loss (Makofske, et al., 99). MHealth was written in Java but needs 
mtrace for its operation. Version 1.0 can be downloaded at: 


http://steamboat.cs.ucsb.edu/mhealth/download-v1.0/. 
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Figure 2.5 MHealth display showing participants in a 


multicast tree (Robinson, et al., 96). 


D. VRTP 


The Virtual Reality Transfer Protocol (vrtp) is a protocol being developed to 
provide client, server, multicast streaming and network-monitoring capabilities in support 
of internetworked 3D graphics and large-scale virtual environments (LSVEs) (Brutzman, 
99). vrtp is designed to support interlinked VRML worlds in the same manner as http 


was designed to support interlinked HTML pages. The intent is to develop a free library 


to provide any machine with client, server, peer-to-peer and network monitoring 
capabilities to navigate and join large, interactive, fully internetworked 3D worlds. 
RTP is an integral part of the vrtp architecture, used in both the streaming and 


monitoring components. Figure 2.6 shows the functional design of the vrtp streaming 


behaviors component. 


4a vee © Sen Se AORY Oyayrb- vonat Soy SS Sy Se PIAA K © CPS Z4 23 
Wa ee ee zr 
avi eh Be Lael Fe i mab eat eras, Ze, 2 E: ¥ 
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a sie Parr +Q ° we 
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, EMR Ad 2% IO 


Entity event dispatcher 


Dial-a-behavior protocol 


Real-time transport protocol 


Behavior stream buffer 


| 

| 
Realtime transport protocol, 
(Behavior steam bufer 


Area-of-interest manager 


Universal cient - Intemet ( ) 





Figure 2.6 vrtp streaming behaviors component (Brutzman,99). 
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E. INTERNET 2 SURVEYOR 


The university community has joined together with government and industry 
partners to accelerate the next stage of Internet development. The Internet2 project is 
bringing focus, energy and resources to the development of a new family of advanced 
applications to meet emerging academic requirements in research, teaching and learning 
(Advanced Networks, 97). 

Surveyor is a measurement infrastructure that is being currently deployed at 
participating sites around the world. Based on standards work being done in the Internet 
Engineering Task Force IETF), Surveyor measures the performance of the Internet 
paths among partcipating organizations. The project is also developing methodologies 
and tools to analyze the performance data. The project aims to create the infrastructure 
and tools that will improve the ability to understand and effectively engineer the Internet 
infrastructure (Advanced Networks, 97). Surveyor monitoring workstations installed at 
NPS are expected to provide a controlled network environment supporting RtpMonitor 


work. 


ue DESIGN PATTERNS 


Design Patterns are reusable solutions to recurring problems that occur during 
software development. In 1995, the book “Design Patterns” (Gamma, 95) has started 
popularizing the idea of patterns. In recent years, new patterns have been proposed and 
several books about patterns have been released. Frequently, books about Design Patterns 
give examples of pattern implementations in some computer language. A good book for 
studying patterns in Java was written by Mark Grand (Grand, 98). Sun Microsystems’ 


Java Application Programming Interfaces (APIs) contain plenty of examples of pattern 


- 


ibs) 


use. Design patterns provided great benefit during the software analysis, design and 


implementation work in this thesis. 
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Ill. REAL-TIME TRANSPORT PROTOCOL (RTP) 


A. INTRODUCTION 


This chapter presents the Real-time Transport Protocol (RTP) functionality and 
packet format. RTP is a header format and control protocol designed to support 
applications transmitting real-time data (such as audio, video, or simulation data), over 
multicast or unicast network services. RTP was proposed by RFC1889 (Schulzrinne, et 


al., 99) and has received wide acceptance. 


B. OVERVIEW OF TRANSPORT RELATIONSHIPS 


The transport layer provides a flow of data between hosts. In the TCP/IP protocol 
suite there are two vastly different transport protocols: the Transmission Control Protocol 
(TCP) and the User Datagram Protocol (UDP). While TCP provides a reliable flow of 
data between two hosts, by using packet acknowledgements and retransmissions, UDP 
just sends single packets with no guarantee that the packets will be received at the other 
side. 

RTP does not provide all the functionality required by a transport protocol. It is 
intended to run over some transport protocol, such as UDP, primarily in multicast mode. 
TCP is not suitable for real-time audio/video transfers because packet loss implies in 
retransmissions that affect delay-sensitive data. Also TCP does not support multicasting. 
Despite the implication of its name, RTP does not provide any means to ensure timely 
delivery or to guarantee a desired quality of service. In fact, RTP was designed to satisfy 
the needs of multi-participant multimedia conferences, where the loss of some packets or 


some small delay will not affect the session significantly. 


Basically, the RTP header provides a sequence number and a timestamp in each 
packet, allowing the timing reconstruction of the receiving stream. Additionally, RTP 
header specifies a payload type, allowing different data formats to originate from 
different senders in a single session. Further parameters in the RTP packet header are 
defined ina media-specific manner. 

RTP is used together with the RTP Control Protocol (RTCP), which provides 


mechanisms of synchronization, source identification and quality-of-service feedback. 


C. RTP 


This section summarizes RTP, which 1s formally described in RFC1889 


PSChMizninneweedieee ss ). 


1. RTP Units: Mixer, Translator and Monitor 


A Mixer is an intermediate system that receives streams of RTP data packets from 
one or more sources, possibly changes the data format, combines the streams in some 
manner and then forwards the combined stream. A mixer sends its data just as if it were a 
new source. 

A Translator is an intermediate system that forwards packets without changing its 
source description. Translators can be used as devices to convert encodings, such as 
replicators from multicast to unicast, and such as application filters in firewalls. 

A Monitor is an application that receives RTCP packets sent by all participants to 


estimate the quality of service for distribution monitoring, fault diagnosis and long-term 
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statistics. The monitor is likely to be built into the applications participating in a session, 
but it may also be a separate application that does not send or receive RTP data packets 
such as third-party monitors. 

RTP is designed to connect several end-systems in single or multiple sessions. An 
end-system sends and/or receives RTP data packets. In addition, RTP supports the notion 
of Translators and Mixers, which can be considered intermediate systems at the RTP 
level. The need for these systems has been established by experiments with multicast and 


video applications, especially for dealing with low-bandwidth connections and firewalls. 


2. RTP Header 


A RTP header precedes each RTP packet. Figure 3.1 represents an RTP header. 












0 4 6 cal 
EC 


synchronization source (SSRC) identifier 








contributing source (CSRC) identiriers 








Figure 3.1 RTP Header Contents (Schulzrinne, et al., 99). 


The following information is part of the header: 


e Version (V): 2 bits - Identifies the version of RTP. The current version 
defined in RFC1889 is two (2). 


e Padding (P): | bit - If the padding bit is set, the packet contains one or more 
additional padding bytes. The last byte contains the number of padding bytes, 
including itself. The RTP header has no packet length field. 
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e Extension (X): 1 bit - If this bit is set the header will be followed by a header 
extension. 


e CSRC count (CC): 4 bits - Contains the number of contributing source 
identifiers in the header. 


e Marker (M): 1 bit — Can be used by a profile. 


e Payload type (PT): 7 bits - Identifies the type of data (payload) carried by the 
packet. The payload types for standard audio and video encodings are defined 
in RFC1890 (Schulzrinne, 99). 


e Sequence number: 16 bits - It is incremented each time a packet is sent. The 
initial value is randomly generated. 


e Timestamp: 32 bits - This field reflects the sampling instant of the first byte of 
data. The clock frequency depends of the data type. For example, if audio data 
is being sampled at 8K Hz, and each audio packet has 20 ms of samples (160 
sample values), the timestamp should be increased by 160 each 20 ms. The 
timestamp initial value should be random. 


e SSRC: 32 bits - This field identifies the synchronization source. It is a number 
chosen randomly. It must be unique among all participants in a session. There 
is a mechanism to solve conflicts when two sources choose the same number, 
described in Session 8 of RFC1889. A participant need not use the same 
SSRC identifier in all sessions of a multimedia session. 

e CSRC list: 0 to 15 items, 32 bits each - The CSRC list identifies the 
contributing sources for the payload contained in this packet. It is used only 


by mixers, which combine several streams from different sources in a single 
stream. 


3. Profiles and RTP Header Extension 


The RTP protocol is designed to be malleable and to allow modifications and 
additions as defined by the corresponding media profile specification. Typically each 
application only operates under one profile. For example, RFC1890 (Schulzrinne, et al., 


99) defines a profile for audio and video conferences. 
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In the RTP fixed header, the marker bit (M) and the payload type (PT) fields carry 
profile-specific information. If the marker bit is set, a header extension will be added to 
the RTP fixed header to provide the additional data functionality required for the profile. 


The header extension has the following format seen in Figure 3.2. 


defined by the profile Length (# of 32-bit words) 


header extension data 





Figure 3.2 RTP Header Extension (Schulzrinne, et al., 99). 


The length field defines the number of 32-bit words of the header extension, 
excluding the first one. Therefore, zero is a possible value. Only a single variable-length 


header extension can be appended to the RTP header. 


D. RTP SESSION ADDRESSING 


A session 1s an association among participants. It is defined by two transport 
parameter pairs (two network addresses plus corresponding port numbers). One transport 
address is used for transmitting RTP packets and the other is used for RTCP packets. The 
destination transport address pair may be the same for all participants when using 
multicast, or may be different for each when using unicast. For multicast UDP, the 
multicast address for RTP and RTCP in a session must be the same, the RTP port must be 
even, and the RTCP port must be the next higher (odd) port number. Multiple RTP 
sessions are distinguished by different port number pairs and/or different multicast 


addresses. 


ws 


Some applications like audio and videoconferences require the use of two 
sessions: one for audio and the other for video. Distinct media types should not be carried 
in a Single session, because of the different timing and bandwidth requirements. 

Figure 3.3 shows three different multicast conferences configurations. Part a) is a 
single media conference, represented by a single session. Part b) and c) represent two 


possible configurations for a conference with two types of media, e.g. audio and video. 


E. RTP CONTROL PROTOCOL (RTCP) 


RTCP provides back-channel monitoring and synchronization for use with RTP 
streams. RTCP provides a periodic transmission of control packets to all participants in 
the session. RTCP performs the following functions: 


e Feedback on the quality of the data distribution. Receivers must periodically 
send RTCP packets containing a set of information related to the quality of 
each sender transmission, such as the number of lost packets, fraction of lost 
packets, delay times and jitter (variations in delay). 


e Provides information about the participants in the session. Each participant 
must periodically send their canonical name (CNAME), e-mail address, 
telephone number and so on. The canonical name must be unique among the 
participants of a multimedia session (a group of sessions). The CNAME 1s 
sent together with the SSRC identifier, allowing the detection of any collision 
in choosing the SSRC identifier in a session. 


e Media synchronization. RTCP conveys information about the absolute time 


(wallclock) for each participant. If the senders are synchronized, it will be 
possible to synchronize the different media in a session. 
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Figure 3.3 RTP Addressing Configuration Examples. 


As all participants must send RTCP packets, the rate must be controlled to avoid 
excessive RTCP traffic as the number of participants scales up. This, each participant 
must control his RTCP rate to guarantee that RTCP packets correspond to less than 5% of 
the RTP session. Also, it is recommended that at least “% of the RTCP bandwidth would 
be dedicated to senders. When the proportion of senders is greater than “% of the 
participants, the sender gets its proportion from the full RTCP bandwidth. It is further 
recommended that the interval between RTCP transmissions by each participant should 
always be greater than 5 seconds. 


RFC1889 defines five types of RTCP packets: 


e SR: Sender Report, for transmission and reception of statistics from 
participants that are active senders. 


e RR: Receiver Report, for reception statistics from participants that are not 
active senders. 


e SDES: Source Description, for each participant transfer information about 
himself. 


e BYE: to notify the end of participation. 

e APP: application specific functions. 

Multiple RTCP packets need to be concatenated without any separator to form a 
compound RTCP packet. Each participant must send RTCP compound packets with at 


least one SR or RR and one SDES with his CNAME. 


1. Sender Report (SR) 


A Sender Report is issued if the participant has sent any RTP data packets since 
the last report, otherwise a Receiver Report (RR) is issued. A sender report, besides 


having statistical information about itself, may contain reception Statistics of a maximum 
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of 31 other senders. If a sender has more than 3] receiver statistics to send then, it must 
add a RR to the compound packet. The format of the Sender Report is shown in Figure 
3.4. 

The Sender Report packet consists of three sections: a header section, a sender 
information section, and a receiver information section. A fourth profile-specific 
extension section can be defined. The fields have the following meaning: 


e Version (V): 2 bits - Identifies the version of RTP. The version defined in 
RFC1889 is two (2). 


0 3 8 16 Srl 







SSRC of sender 





. . . e 


NTP timestamp, most significant word 










NTP timestamp, least significant word 


RTP timestamp 
sender’s packet count 


sender’s byte count 
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cumulative number of packets loss 








extended highest sequence number received 


finterarrival Sitter 
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delay since last SR (DLSR) 


SSRR Z (SSRC Of the first source) 


profile-specific extensions 








Figure 3.4 RTCP Sender Report (SR) Format (Schulzrinne, et al., 99). 
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Padding (P): 1 bit - If padding bit is set, the packet contains one or more 
additional padding bytes. The last byte contains the number of padding bytes, 
including itself. The padding bytes are included in the length field. Only the 
last packet of a compound packet can use padding. 


Reception report count (RC): 5 bits - The number of reception report blocks 
contained in this packet. 


Packet type (PT): 8 bits - It is set to 200 to identify a SR packet. 


Length: 16 bits- The length of the SR packet in 32-bit words minus one, 
including the header and any padding. 


SSRC: 32 bits - The synchronization source identifier for this originator of 
this SR packet. 


NTP timestamp: 64 bits - Indicates the wallclock time when this report is 
sent. The wallclock represents the absolute day and time using the timestamp 
format of the Network Time Protocol (NTP), described in RFC1305. The full 
resolution NTP timestamp is a 64 bit unsigned number with 32 bits for the 
integer part and 32 bits for the fractional part. It represents the number of 
seconds relative to Oh UTC on 1 January 1900. 


RTP timestamp: 32 bits - Corresponds to the same time as the NTP timestamp 
above, but in the same units and with the same random offset as the RTP 
timestamp in data packets. This correspondence may be used for intra-media 
and inter-media synchronization for sources whose NTP timestamps are 
synchronized. 


Sender’s packet count: 32 bits - The total number of packets transmitted by 
the sender sincé starting transmission until the time the SR packet was 
generated. The count should be reset if the sender changes its SSRC identifier. 


Sender’s byte count: 32 bits - The total number of payload octets (i.e. not 
including header or padding) transmitted in the RTP data by the sender since 
starting the transmission until this SR packet was generated. The count should 
be reset if the sender changes its SSRC identifier. 


SSRC_n: 32 bits - The SSRC identifier of the source to which the information 
in this block pertains. 


Fraction lost: 8 bits - The fraction of RTP data packets from source SSRC_n 


lost since the previous SR or RR packet. It is represented as a fixed-point 
number with the binary point at the left edge of the field. 
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Cumulative number of packets lost: 24 bits - The total number of RTP data 
packets from source SSRC_n that have being lost since the beginning of the 
reception. 


Extended highest sequence number received: 32 bits - The low 16 bits contain 
the highest sequence number received in an RTP data packet from source 
SSRC_n. The most significant 16 bits extend that sequence number with the 
corresponding count of sequence number cycles. 


Interarrival jitter: 32 bits - An estimate of the statistical variance of the RTP 
data packet interarrival time, measured in timestamp units and expressed as an 
unsigned integer. 


Last SR timestamp (LSR): 32 bits - The middle 32 bits out of 64 bits in the 
NTP timestamp received as part of the most recent RTCP SR packet from the 
Source SSK on: 


Delay since last SR (DLSR): 32 bits - The delay, expressed in units of 
1/65536 seconds, between receiving the last SR packet from source SSRC_n 
and sending this reception report block. Based on this information and the 
LSR the sender can compute the round trip propagation delay to this receiver. 
This can be done by the following formula: Round Trip = A- LSR- DLSR, 
where A is the time the receiver gets the RR message. Figure 3.5 is a time 
diagram that represents the DLSR. 


Receiver Report (RR) 


The format of the Receiver Report (RR) is the same of the Sender Report (SR) 


except that the packet type field contains the value 201 and that there is no sender 


information section. 


An empty RR packet (RC=0) must be put at the head of a compound packet when 


there is no data transmission or reception to report. Figure 3-6 shows the Receiver Report 


packet format. Figure 3.6 represents a Receiver Report packet format. 


ve | 


sender receiver 





Figure 3.5 Delay Since Last SR (DLSR) Time Diagram. 
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Figure 3.6 Receiver Report (RR) Format (Schulzrinne, et al., 99). 


3. Source Description (SDES) 


The SDES packet consists of a header section and zero or more chunks of data. 
Each chunk is composed of items describing the source identified in that chunk. The 


SDES packet format is shown in Figure 3.7. 
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Figure 3.7 Source Description (SDES) Packet Format (Schulzrinne, et al., 99). 


The fields in the SDES packet are: 

e Version (V), Padding (P) and length - As described for SR and RR packets. 

e Packet type (PT): 8 bits - It 1s set to 202 to identify a SDES packet. 

e Source count ( SC): 5 bits - The number of SSRC/CRCS chunks contained in 
this packet. 


The SDES item format is shown in Figure 3.8. 


8 


0 16 n 


Figure 3.8 SDES Item Format (Schulzrinne, et al., 99). 


The fields in each SDES item are: 


e Type: 8 bits - Contains a value to identify a type of description. The following 
values are defined in RFC1889: 
Canonical Name — | 
Name — 2 
Email —3 
Phone — 4 
Location — 5 
Tool — 6 
Note — 7 
Private Extensions — 8 


e Length: 8 bits - The length of the chunk content, in bytes. 

e Content - Consists of text encoded in UTF-8 encoding specified in RFC2279. 
This field is continuous and it is not limited to a 32-bit boundary. The field 
must be terminated with a null octet, and followed by zero or more null octets 
until the next 32-bit boundary. This kind of padding is separated from the one 
specified with the Padding bit in the header. 

Canonical name is the only mandatory SDES item. It must be sent on each RCTP 
packet. As the canonical name will be used to identify a participant in single and multiple 
RTP sessions, it must be unique. CNAME will be use to solve collisions with the SSRC 
identifiers. A participant may have multiple SSCR identifiers, one for each related 
session he is in, but he must have only one CNAME. As CNAME should provide 


information in order to locate a source, its recommended formats are user@full hostname 


or user@I]Paddress. 


4. Goodbye (BYE) 


The BYE packet indicates that one or more participants are no longer active. The 


packet has the format shown in Figure 3.9. 
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Figure 3.9 BYE Packet Format (Schulzrinne, et al., 99). 


The header section has the same format of the previous RTCP packets. Following 
the header there is list of all participants that are leaving the section. The reason for 
providing the capability for more than one source in the BYE packet is the Goodbye 
packet sent by a mixer. If a mixer shuts down, it must send a BYE packet listing its SSRC 
and the CSRC of all sources it handles. 

The last section is optional. It gives a reason by leaving a section, like “bad 
reception” or “time for lunch.” The “length” and “reason for leaving” fields have the 


same behavior as “length” and “context” fields of the SDES item. 
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F. MULTIMEDIA IN RTP 


Each media must be carried in a distinct RTP session. Interleaving packets with 
different RTP media types but using the same session and SSRC is not permitted, in order 
to avoid the following problems: 

e AnSSRC has only one single timing and sequence number. Different payload 
types would require distinct timing spaces. Also there would be no means to 


identify which media suffered losses. 


e The RTCP sender and receiver reports can only describe one timing and sequence 
number space per SSRC and do not carry a payload type field. 


e AnRTP mixer would not be able to combine interleaved streams of incompatible 
media onto one stream. 


e It would not be possible to use different network paths or resource allocations for 
each media. 


G. ANALYSIS OF SR AND RR REPORTS 


It is expected that reception quality feedback data will be useful not only for the 
senders but also for receivers and third-part monitors. The senders can modify its 
transmission based of the feedback; receivers can determine where the problems are 
local, regional or global; network managers may use profile-independent monitors that 
receive only the RTCP packets and not the corresponding RTP data streams to evaluate 
the performance of their networks for multicast distribution. These mechanisms also 
support protective and corrective mechanisms such as congestion avoidance and 
congestion control. 

The interarrival jitter field provides a short-term measure of network congestion. 


The packet loss metric tracks persistent congestion, while the jitter measure tracks 
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transient congestion. The jitter measure may indicate congestion condition forming 


before it leads to packet loss. 


H. RTP PROFILES AND PAYLOAD FORMAT SPECIFICATIONS 


RTP is intended to be tailored through modifications and/or additions to the 
headers as needed. Multiple profiles have been defined, each with different 
characteristics. Therefore, for a given application, a complete specification will require 


one or more companion documents, as follows. 


1. Profile Specification Documents 


A Profile Specification Document defines a set of payload type codes and their 
mapping to payload types. A profile may also define extensions or modifications to RTP 
that are specific for that kind of applications. The only profile document issued as of this 
writing is RFC 1890 - RTP Profile for Audio and Video Conferences with Minimal 


Control. 


Jae Payload Format Specification Documents 


A Payload Format Specification Document defines how a particular payload, such 
an audio or video encoding, is to be carried in RTP. There is an Internet-Draft containing 
guidelines to be followed by Payload Format Specification Documents (Handley, 99). 
Several payload format specifications were proposed so far, most of them related to audio 
and video encodings. Below is a list of payload format RFCs and Internet-Drafts: 

e RFC 2032 - RTP Payload Format for H.261 Video Streams. 

e RFC 2029 - RTP Payload Format of Sun's CellB Video Encoding. 


e RFC 2190 - RTP Payload Format for H.263 Video Streams. 
e RFC 2198 - RTP Payload for Redundant Audio Data. 


e RFC 2250 - RTP Payload Format for MPEGI/MPEG2 Video. 

e RFC 2343 - RTP Payload Format for Bundled MPEG. 

e RFC 2429 - RTP Payload Format for the 1998 Version of ITU-T Rec. H.263 
Video. 

e RFC 2431 - RTP Payload Format for BT.656 Video Encoding. 

e RFC 2435 - RTP Payload Format for JPEG Compressed Video. 

e RTP Payload for Dial-Tone Multi-Frequency (DTMF) Digits. 

e RTP Payload Format for X Protocol Media Streams. 

e RTP Payload Format for MPEG-4 Streams. 

e RTP Payload Format for User Multiplexing. 

e RTP Payload Format for Reed-Solomon Codes. 

e RTP Payload Format for Interleaved Media. 

e RTP Payload Format for Telephone Signal Events. 

e RTP Payload Format for DVD Format Video. 


Other RTP related RFCs and Internet-Drafts include: 

e RFC 2354 - Options for Repair of Streaming Media. 
e RFC 2508 - Compressing IP/UDP/RTP Headers for Low-Speed Serial Links. 
Real-Time Protocol Management Information Base. 
Sampling the Group Membership in RTP. 

Issues and Options for RTP Multiplexing. 


Conformance Texts for RTP Scalability Algorithms. 
e RTP Testing Strategies. 


I. SUMMARY 


The Real-Time Transport Protocol (RTP) provides a way to transmit time-based 
media over wide-area networks (WAN), adding synchronization and feedback features 
over the existing transport protocol. Although RTP was initially devised for application 
in audio and video conferences, this protocol can be applied to convey other types of 


streamed media across the network. 
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IV. JAVA MEDIA FRAMEWORK (JMF) 


A. INTRODUCTION 


This chapter provides an overview of the Java Media Framework (JMF) basic 
architecture and the specialized set of classes to manage RTP transmission, reception and 
control. Several Unified Modeling Language (UML) (Booch, et al, 97). 
diagrams are used to illustrate JMF classes interdependencies and behavior. The 
software application Rational Rose 981 (Rational, 99) was used to import the class 
components from the JMF API and to draw these diagrams. Appendix A contains a 


description of how UML diagrams can be prepared using the software Rational Rose 981. 


B. OVERVIEW 


Java Media Framework (JMF) is a Java Application Programming Interface (API) 
developed by Sun Microsystems in partnership with other companies to allow Java 
programs deal with time-based media, especially audio and video (Sun, 99). Time-based 
media can be defined as any data that changes meaningfully with respect to time. It is 
also referred to as streaming media, since it is delivered in a steady stream of packets that 
must be received and processed within a particular timeframe to produce acceptable 
results. 

JMF 1.0, the 1998 version, supports playback of several media types and RTP 
stream reception. JMF 2.0 is being developed by Sun and IBM, and is currently in public 
beta testing. JMF 2.0 provides media capture functionality, file saving and transmission 
of RTP streams, together defining a plug-in API that is intended to enable developers to 


customize and extend JMF functionality. JMF 2.0 early access version was released in 


June 1999. The beta version was released in August 1999 and the final release is being 
expected in Fall 99. This chapter was written based on JMF2.0 early access (Sun, 99), 
and the software development was performed using JMF 1.0, 2.0 early access and 2.0 


beta. 
C. JMF ARCHITECTURE 


The JMF API can be divided into two parts. A higher-level API, called the JMF 
Presentation and Processing API, manages the capturing, processing and presentation of 
time-based media. A low-level API, called the JMF Plug-in API, allows customization 
and extension. Developers working on new capabilities are expected to add software 
elements to the JMF Plug-in API, thereby extending JMF functionality and supporting 
new media types. 

JMF 2.0 uses the following basic classes/interfaces to model the high-level API: 


e MediaLocator - describes the location of a media content. A MediaLocator is 
closely related to an URL, but identifies stream parameters. 


e DataSource — represents the media itself. A DataSource encapsulates the 
media stream much like videotape does for a video movie. This class 1s 
created based gn a Media Locator. 


e Player — provides processing and control mechanisms over a DataSource just 
like a VCR does for a videotape. A Player can also render the media to the 
appropriate output device (e.g. monitor or speakers). 


e Processor — is a specialized type of Player that provides control] over what 
processing is done on the input media stream. Processor supports a 
programmatic interface to control the processing of the media data, and also 
provides access to the output data streams. 


e DataSink — represents an output device other than a monitor and speaker, the 
most common destinations for media output. For example, a DataSink can be 
used to save the media to a file or to retransmit to a network. 


e Manager — handles the construction of Player, Processor, DataSource and 
DataSink objects. 


Figure 4.1 shows some possible connections between the above elements. Part a) 
is the configuration used to play a media stream. In part b) we see a processor creating a 
DataSource object from another DataSource. In part c) a DataSource is passed to a 
DataSink that writes it to a file. Note that multiple DataSource objects can be connected 
via Processors. 

A Player or Processor generally provides two standard user interface components: 
a visual component and a control-panel component. These components can be accessed 
by calling the getVisualComponent and getContro]PanelComponent methods. 

A DataSource represents a media stream which can have multiple channels of 
data called tracks. For example, a Quicktime (Apple, 99) file might contain both audio 
and video tracks. Demultiplexing is the process of separating out the individual tracks of 
a complex stream. 

Inside a Player or Processor several operations can take place. For each operation 
there is a dedicated piece of software called a “plug-in.” There are five types of plug-ins: 


e Demultiplexers - extract individual tracks of media from a multiplexed media 
stream. 


e Multiplexers - join individual tracks into a single stream of data. 

e Codecs — perform media data encoding and decoding. 

e Effect filters — modify the track data in some way, often creating some special 
effect. They can be classified as post-processing or pre-processing effect 
filters, depending on when they are applied in relation to the codec plug-in. 

e Renderers — delivers the media data in a track to presentation device. For 


video, the presentation device is typically the computer screen. For audio, the 
presentation device is typically an audio card. 


b) 





Figure 4.1 JMF High-level API Connection Examples. 


Figure 4.2 shows an example of a Processor internal operation. In this example 
the media has one audio and one video track that are demultiplexed and processed 
individually. At the end they are multiplexed again and become available as another 
DataSource. 

Manager provides access to a protocol-independent and media-independent 
mechanism for constructing and connecting DataSources, Players, Processors and 


DataSinks. A DataSource can be created by the method createDataSouce, with a 
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parameter specifying either a MediaLocator or URL. A Player or Processor can be 
created by the method createPlayer or createProcessor. The argument may be a 
DataSource, a MediaLocator or a URL. In order to create a Player or Processor from a 
MediaLocator or URL, the Manager first tries to create a DataSource. At last, for creating 
a DataSink a Manager has to receive a DataSource and a MediaLocator as argument. The 
DataSource represents the input to the DataSink and the MediaLocator describe the 


destination of the media to be handled by the DataSink. 
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Figure 4.2 Processor Decomposition (Sun, 99). 


The JMF class hierarchy can be extended by implementing new plug-in interfaces 
to perform custom processing on a track, or by implementing new DataSources, Players, 


Processors or DataSinks. New plug-ins must be registered with the class PlugInManager. 
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New Players, Processors, DataSources and DataSinks must be registered with the class 


PackageManager. 


D. RTP SESSION MANAGER API 


The RTP Session Manager API 1s the part of JMF API that deals with RTP/RTCP 
transmission and reception. It is contained in two packages: javax.media.rtp and 
javax.media.rtp.session. 

The RTPSessionManager interface 1s responsible for entering mandatory 
conventions for creating, maintaining and closing an RTP session. It detects incoming 
RTP streams, maintains a list of RTP participants and transmits outgoing streams. It also 
keeps track of global statistics about the session. 

Since javax.media.rtp.session.RTPSessionManager is an interface, an 
implementation is provided by Sun in the file jmf.jar. The class name is RTPSessionMegr. 
There is currently no source code available for this package. The following line creates 
an RTPSessionManager: 


RTPSessionManager mgr = new com.sun.media.RTP.RTPSessionMgr (); 


1. RTP Streams 


RTPStream is an interface that represents a series of data packets originated from 
a single host. There are two sub-interfaces of RTPStream: RTPRecvStream and 
RTPSendStream. The first represents a stream that 1s being received from a remote 
participant. RTPSessionManager creates RTPRecvStream objects automatically when 


new receiving streams are detected. The second represents a stream being sent by a local 


participant. RTPSessionManager creates new RTPSendStream objects when the method 


createSendStream is called, using a DataSource object as argument. 


2; RTP Participants 


RTPParticipant is an interface that represents one participant in an RTP session. A 
participant may be the source of zero or more streams. The method getStreams returns a 
vector containing all RTPStream objects owned by the participant. 

RTPParticipant has two sub-interfaces: RTPRemoteParticipant and 
RTPLocalParticipant. These are only marker interfaces, with no extra functionality. The 
RTPSessionManager creates a new RTPRemoteParticipant whenever a new RTCP packet 
arrives that contains a CNAME that has not been seen before. The association between 
the RTPParticipant object and a RTPRecvStream is done using the SSRC identifier. It is 
possible to have an unassociated RTPRecvStream as the source can start sending RTP 
packets before a CNAME RTCP packet 1s sent. 

A participant that sends no data is called a Passive Participant. Otherwise it is 
called an Active Participant. The method getAllParticipants of RTPSessionManager 
returns a vector with all RTPParticipants. Similar methods exist to return vectors with 


remote, local, active and passive participants. 


3: RTCP Source Description 


RTCPSourceDescription is a class that contains one description information 
related to a participant, as received by the RTCP SDES packets. So, associated with a 
RTPParticipant object there may be several RTCPSourceDescription objects, each 


representing one description information, as CNAME, name, e-mail, location, tool, etc. 


The method getSourceDescription of RTPParticipant returns a vector with the 


RTCPSourceDescription objects related to the participant. 


4. RTCP Report 


Passive participants send RTCP RR packets as a feedback about the reception of 
incoming streams. Active participants send RTCP SR packets that give information about 
the stream being sent and also include feedback about the reception of incoming streams. 
So, a SR packet includes the RR packet information. A RTCP SR or RR packet is 
originated from each SSRC identifier. A participant may have more than one SSRC 
identifier if it is source of more than one stream in the same session. Each SSRC is 
related to one stream. In spite of it, each participant has only one CNAME. RTCP SDES 
packets allow the correlation between SSRC and CNAME. 

In JMF there is an interface called RT'CPReport to represent both RTCP SR and 
RTCP RR packets. RTCPReport has two sub-interfaces: RTCPSenderReport and 
RTCPReceiverReport. RTCPReceiverReport is a marker interface. All of its functionality 
is contained in RTCPReport. RTCPSenderReport extends RTPCReport to provide 
methods for retrieve sender report information. The method getReports of 
RTCPParticipant returns a vector containing the last SR or RR reports sent by the 
participant. This method will usually return only one report: SR if the participant is active 
and it sends only one stream, and RR if the participant is passive. If the participant sends 
more than one stream this method will return the same number of SR reports, because 
each SR report is associated to one stream/SSRC. 

RTCPReport has a method called getFeedback that returns a vector of 


RTCPFeedback objects. Each RTCPFeedback object conveys information about the 


as 


reception of one incoming stream. In other words, it represents a feedback from a SSRC 
about other SSRC that originates a stream. Feedback information includes fraction lost, 
cumulative number of packets lost, etc. 

Figure 4.3 contains a class diagram describing the relationship between 
RTPParticipant and other classes/interfaces discussed so far. This class diagram uses the 


standard notation specified for the Unified Modeling Language (UML) (Booch, et al, 97). 
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Figure 4.3 RTPParticipant Class Diagram. 
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5. Event Listeners 


The RTP API has four types of event listeners: RTPSessionListener, 
RTPSendStreamListener, RTPReceiveStreamListener and RTPRemoteListener. These 
listeners provide a mechanism of event notification on the state of the RTP session and its 
streams. 

The RTPSessionListener interface detects events related to the RTP session as a 
whole rather than a particular stream or participant. Two types of events can be posted: 
NewparticipantEvent, generated when a RTCP packet from an unknown participant was 
received, and LocalCollisionEvent, generated when a SSRC collision was detected 
between the local participant and a remote one. 

The RTPSendStreamListener interface detects state transitions that occur on a 
RTPSendStream. Four types of events can be posted: 


e NewSendStreamEvent — generated when a new transmitting stream has been 
created. 


e ActiveSendStreamEvent — generated when the transfer of data from the 
DataSource object has started arriving after a previous stop. 


e InactiveSendStreamEvent — generated when the transfer of data from the 
DataSource object has stopped. 


e SendPayloadChangeEvent — generated when the payload type of the 
DataSource object has changed. 


The RTPRecvStreamListener interface detects state transitions that occur on a 
RTPRecvStream. Seven types of events can be posted: 
e NewRecvStreamEvent — generated when a new incoming stream has been 


detected. This means that RTP data packets has been received from a SSRC 
that had not previously been sending data. 
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e ActiveRecvStreamEvent — generated when the stream data packets have 
started arriving after a previous stop. 

e InactiveSendStreamEvent — generated when the stream data packets have 
stopped arriving. 


e PayloadChangeEvent — generated when a remote sender has changed the 
payload type of a data stream. 


e TimeOutEvent — generated when a remote sender has not sent packets for a 
while and can be considered timed-out. A time-out has the same effect as if 
the participant has sent the RTCP BYE packet. 

e RecvStreamMappedEvent — generated when a recently created stream has 
been associated with a participant after the first RTCP packet has been 
receiv ca. 

e AppEvent — generated when an RTCP APP packet has been received. 

The RTPRemoteListener interface detects events related to RTCP control 

messages received from remote participants. This interface can be used for monitoring 
applications that do not need to receive each stream, but only RTCP reports. Three types 


of events can be posted: 


e RecvReceiverReportEvent — generated when anew RTCP RR report has been 
received. 


e RecvSenderReportEvent — generated when a new RTCP SR report has been 
received. | 


e RemoteCollisionEvent — generate when two remote participants are using the 


same SSRC simultaneously. Upon detecting the collision, both remote 
participants should start sending data with new SSRCs. 


6. RTP Media Locator and RTP Session Address 


RTPMediaLocator 1s a class that stores information about the session address and 
other settings used in a session like TTL and SSRC. The format is similar to an URL. 
The RTP MediaLocator string is of the form: 


- rtp://address:port[:SSRC}/content-ty pe/[TTL] 
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Optional parameters are enclosed in brackets. Address is the IP address of the 
session. Port is the port number used for RTP packets. It must be an even number 
according RFC1889. SSRC 1s optional. Content-type can be either “audio” or “video.” 
TTL is the time-to-live, also optional. The string above is used to create a 
RTPMediaLocator object. If the media locator is invalid a MalformedRTPMRLException 
will be thrown. 

The class RTPMediaLocator has several methods to retrieve the above 
information about a session. For example, the method getSessionAddress returns a string 
with the IP address and the method getSessionPort returns an integer with the RTP port 
number. However, to create a session and instantiate a RTPSessionManager under JMF, 
another object has to be created first: an RTPSessionAddress. 

RTPSessionAddress is a class that encapsulates a pair of multicast addresses, each 
constituting of an IP address and a port number. One multicast address is used by RTP 
and the other by RTCP. (In fact, this definition of a RTPSessionAddress is too broad, 
because RFC1889 says that the RTCP multicast address must have the same IP address 
and a immediately higher port with relation the RTP address.) Also, RTP port must be 
even by RFC1889. 

In order to create a RTPSessionAddress object for representing a session address, 
two InetAddress objects are required as arguments, one for RTP and other for RTCP. The 
InetAddress class is part of the java.net package and encapsulates an IP address. The 
static method getByName can create a InetAddress object given a string with the IP 
address. Figure 4.4 contains a sequence diagram that describes the creation of a 


RTPSessionAddress object. 
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user program | RTPMedia InetAdress  RTPSession | 

Locator | Address | 
create( String mediaLocator) | | 

address = getSessionAddress() | 


| port = getSessionPort() 


| 
; ”t”*~<“~‘ 








destaddr = getByName(address) 





sessaddr = create( destaddr, port, destaddr, port + 1) 


| at 








Figure 4.4 RTPSessionAddress Creation UML Sequence Diagram. 


te RTP Session Manager 


After creating an empty RTPSessionManager object as described in item C), a 
RTPSessionManager must be initialized by calling the method initSession. The required 
parameters are: 


e The local IP address as a RTPSessionAddress object. This object can be 
created by calling the RTPSessionAddress constructor with no arguments. 


e Anarray of RTPSourceDescription objects containing information about the 
local participant. 


e The fraction of the bandwidth to be allocated to RTCP. RFC1889 
recommends 5% of the RTP bandwidth. 
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e The fraction of the RTCP bandwidth to be allocated to Sender Reports. 
RFC1889 recommends 25% of the RTCP bandwidth. 


At this moment the RTPSessionManager is still not active. The method 
startSession must be called in order to cause RTCP reports be generated and callbacks to 
the several listeners to be made. This method must be called prior to the creation of any 
streams on a session. The required parameters are: 

e The session address as a RTPSessionAddress object. 

e The time-to-live (TTL) 


e ARTPEncryptionInfo object if any encryption is desired. 


8. Receiving and Presenting RTP Media Streams 


After RTPSessionManager has been started, any receiving stream will 
generate a RTPRecvStream object and a NewRecvStreamEvent event. In the update 
method of the interface RTPRecvStreamListener, the RTPRecvStream object can be 
obtained by the method getRecvStream of NewRecvStreamEvent. By retrieving the 
DataSource from the RTPRecvStream object and passing it to the Manager we can create 
a Player for the received stream. The class PlayerWindow, supplied by Sun, receives a 
Player, plays back the media, audio or video, and creates a control window. Figure 4.5 
contains a collaboration diagram describing the sequence above. This collaboration 
diagram uses standard notation for showing logical relationship between instantiated 


objects, as specified by UML (Booch, et al, 97). 
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event: NewRecvStreamEvent 


| 1: update( event ) 
| ee 2: stream = getRecvStream() 


RTPRecvStreamListener | ——> stream: RTPRecvStream 
3: ds= getDataSource() 


5: create( player ) 
a 


4: player = createPlayerds) 








Figure 4.5 RTP Media Presentation Collaboration Diagram. Numbered 
arrows indicate the sequence of method calls occurring between objects. 


9. Transmitting RTP Streams 


RTP stream can be transmitted by passing a DataSource object to the Session 
Manager using the method createSendStream. As a DataSource can contain multiple 
streams/tracks, an index of the stream must be specified. The DataSource is usually 
obtained as an output of a Processor. In this case the Processor has to generate RTP- 
encoded data because the Session Manager does not perform that function. So each track 
to be transmitted has to be set to an RTP-specific format. The method setFormat of the 
TrackControl interface allows a Processor to set the format of a track. If the format can 


not be applied to the track, an IncompatibleFormatException is thrown. 
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If the physical source of the stream is intended to be camera or microphone, a 
CaptureDeviceInfo object must be created by using the method getDevice of 
CaptureDeviceManager. The argument passed to the method getDevice is a Format 
object, which describes a media format. The CaptureDeviceManager searches for a 
device in the system that supports the desired format. The method getLocator of 
CaptureDevicelnfo returns a Media Locator that can be used to create a Processor. 

Figure 4.6 contains a UML collaboration diagram that describes a JMF procedure 


to capture the media and transmit it in a RTP session. 


CaptureDevice | | di:CaptureDeviceinfo 
Manager | 


] 


Manager 


1: di= getDevice(format) 





Ze, | tLocat = 
: loc = getLocato 
z 0 3: proc = createProcessor(loc) 


4: tc = getT rackControls) 
proc : Processor | 


6: ds= getDataOutput() 


5: setFormat( RTP_format) 
| Vv 7: createSendStream(ds) i 





te:TrackControl 


-RTPSessonManager 





Figure 4.6 Media Capture and Transmission Collaboration Diagram. 
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10. RTP Statistics 


IMF maintains several statistics about the RTP session and its streams. Statistics 
about the session as a whole are obtained through the RTPSessionManager by the 
methods getGlobalTransmissionStats and getGlobalReceptionStats. These methods 
retrieve GlobalReceptionStats and GlobalTransmissionStats objects respectively, which 
have methods to get each statistic. Individual stream statistics are maintained within 
RTPSendStream and RTPRecvStream objects by the RTPTransmissionStats and 
RTPReceptionStats interfaces. Figure 4.7 contains a UML class diagram showing the 


classes mentioned above. 
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Figure 4.7 RTP Statistics Class Diagram. 
53 


D. SUMMARY 


The Java Media Framework (JMF) architecture is intended to support multimedia 
in a variety of applications. It is based in a high level API, containing generic classes to 
capture and present media, and a low-level API to allow customization and extension. 
The RTP API supports RTP transmission and reception, as well as retrieval of RTP 
statistics. Future work on JMF can include the transmission of time-based media other 
than audio and video, such as the Distributed Interactive Simulation (DIS) protocol and 


other behavior-based streams. 
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V. DESIGN AND IMPLEMENTATION OF THE 


RTPMONITOR APPLICATION 


A. INTRODUCTION 


This chapter covers the functionality and class design of the program developed 
as the main goal of this thesis, called rtpMonitor. rtpMonitor is a Java application that 
presents and records RTP statistics about a single RTP session. It can also present the 
media being received, either audio or video, by launching audio/video playback windows. 
All Unified Modeling Language (UML) diagrams in this chapter conform to the UML 
Specification (Booch, 97) and were prepared using the Java to UML facilities of 


Rational Rose 981 (Rational, 99). 
B. RTPMONITOR FUNCTIONALITY AND INTERFACE 


This section contains a summary of the rtpMonitor functionality. Additional 


information can be found in the Appendix B, the rtpMonitor User Manual. 


i Graphical User Interface (GUI) 


Figure 5.1 shows the rtpMonitor main window. In the “Bookmark” menu, the user 
can select, add or delete a bookmark related to the session name/address. In the 
“Preferences” menu the user can select whether the monitor will participate in the 
session, play streams and/or record statistics. The user can also be selected the duration of 
the monitoring session, the recording interval and the presentation interval. In the 
“Output files” menu the user can launch an external viewer to see the contents of the 


statistic files generated by the program. 


2), 


The upper part of the window contains the session address, according the 
RtpMediaLocator format and the session name. The user enters the session name when a 
new bookmark is inserted. This name does not necessarily have any relation with the 
session name of the Session Description Protocol (SDP) announcements. The rest of the 


window contains the current RTP statistics. 
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Figure 5.1 rtpMonitor Main Window. 


2 Statistics Display 


The program periodically displays the following information: 
e Global statistics: general reception information about the whole session. 


e Stream statistics: about the reception of a single stream. 
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e Feedback: the RTCP Receiver Report information from all participants about 
the stream being monitored. 


5: Statistics Recording 


rtpMonitor can record statistics in text files using a recording interval defined by 
the user. Several files are created and managed to simplify further retrieval. There are 
files to hold data from the last five minutes, previous five minutes, last hour, previous 
hour and different dates. Multiple file sizes and periodicities are employed to avoid 
excessive file sizes when performing extended monitoring. File name conventions are 


presented in Appendix A. 


4, Media Presentation 


rtpMonitor can present the incoming video stream on the computer screen or the 
incoming audio streams on the computer speakers. This option is selected in the 
“Preferences” menu. In case of video, each stream is presented in a separate window. In 
case of audio, a toolbar window is opened to allow audio controls (such as the mute 


function). The launched applications are part of the JMF API. 


5: Command Line Operation 


If the program is called with any argument in the command line the GUI will not 
be launched. In this case the session address and preferences must be passed by the 


command line. 


oy 


The following command line is an example of invocation of the rtpMonitor to 


record statistical data and present RTP session streams during a period of 24 hours: 


java org.web3d.vrtp.rtp.RtpMonitor rtp://224.120.67.46/64542/12 
-play -record -e 24 


Using the command line version of rtpMonitor no statistics are sent to the 


console. A monitoring session can be stopped by pressing “Crtl-C”. 


C. RTPMONITOR CLASS DESIGN 


The rtpMonitor class design goal was to create a set of basic classes that could 
perform the RTP monitoring tasks with minimal access from user applications to the Java 
Media Framework API. Figure 5.2 contains a data flow diagram showing the exchange of 
data (statistics, settings and commands) between classes in rtpMonitor. Each bubble in 
the diagram will be discussed in the remainder of this session. Appendix C contains the 


rtpMonitor Javadoc, and Appendix D contains the rtpMonitor source code. 


1. RtpMonitorManager and RtpUtil 


The RtpMonitorManager class is the main interface between a user application 


and JMF. It performs the following functions: 


e Creates and starts a session, represented by a RTPSessionManager object in 
JMF. 


e Records session statistics in files. 


e Presents (1.e. plays) incoming media streams. 
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Figure 5.2 RTPMonitor Data Flow Diagram. 


RtpMonitorManager does not have methods to retrieve each single statistic in an 
RTP session. If an application needs access to individual statistics, e.g. for display 
purposes, it is necessary to retrieve the RTPSessionManager object and use its methods to 


get the desired set of statistics. 


>y 


The following parameters are necessary for  instantiating a new 
RtpMonitorManager object: 

e The session address string, e.g. rtp://224.2.134.67:50980/127 

e A Boolean variable indicating if the statistics are to be recorded on files. 

e A Boolean variable indicating if the incoming streams are to be played. 


e A Boolean variable indicating if the monitor will actively participate in the 
session (1.e., send RTCP packets). 


During instantiation, RtpMonitorManager creates a RTPSessionManager object in 
JMF. Figure 5.3 shows a UML sequence diagram representing the steps taken by 
RtpMonitorManager in creating and initializing the session manager. Figure 5.4 shows a 
class diagram of the classes related to RtpMonitorManager. 

RtpUtil is a class that has only static methods for performing some extra 
functionality to JMF. For example, there is a method to return the username given a 


RTPParticipant object. 


Ze RecordTask and FileCatalog 


RecordTask is a class used by RtpMonitorManager objects to write the statistics 
periodically to disk. It is created as a separate thread that waits for a fixed period of time 
after writing data to disk. This class writes data to the file called 
"statisticsLastReport.txt” that contains the last single report only. The 
FileCatalog class is actually responsible for transferring data to other files as well (last 


five minutes, last hour, and so on). 
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Figure 5.3 RTPSessionManager Initialization UML Sequence Diagram. 


3. RtpPlayerWindow 


RtpPlayer Window is a class used to create a window for playing an audio/video 
stream. It is a subclass of PlayerWindow, adding the capacity of modifying the window 
name. Both classes were developed by Sun. RtpPlayerWindow came with JMF1.1 


sample code and PlayerWindow is in the file jmf. jar. 
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Figure 5.4 RTPMonitorManager UML Class Diagram. 
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4. RtpMonitor 


The main RtpMonitor class extends a Frame and implements the rtpMonitor 
Graphical User Interface (GUI). RtpMonitor and RtpMonitorCommandLine can be 
considered classes in the application level. They use the services of RtpMonitorManager 
to provide some user level functionality. RtpMonitor has the following functions: 


e Collects user preferences. It uses the ModifyPreference class as the dialog 
box. 


e Selects, adds and deletes bookmarks. It uses the SelectBookmark, 
AddBookmark and DeleteBookmark classes as dialog boxes. 


e Displays statistics periodically. It creates a DisplayTask object, which is a 


new thread that sleeps for a user-defined time, to call its methods for updating 
the statistics on screen. 


> RtpMonitor Applet 


A good idea might be to make an applet version in a web page. To do this, 
security problems must be addressed, as the monitor must write data to disk and open 
network connections. The implementation of an RTP Monitor version running as an 


applet was left as future work. 


6. RtpMonitorCommandLine 


RtpMonitorCommandLine objects are instantiated by the main method of 
RtpMonitor when some parameter is passed. This class performs the creation of a 
RTPSessionManager object but does not present statistics on screen. 

Several options can be passed by the command line call to RtpMonitor. They are 


basically the same available in RtpMonitor preferences dialog. 
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D. SUMMARY 


The rtpMonitor application allows the monitoring of an RTP session by 
presenting session and stream statistics on screen as well as recording statistics on files 
for future analysis. The program also supports Media presentation of audio and video. 

The design goal of the rtpMonitor was to provide a basic set of classes for RTP 


statistics recording with minimal interfacing with JMF. 
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VI. RTP MANAGEMENT INFORMATION BASE (MIB) 


A. INTRODUCTION 


The RTP Management Information Base (MIB) defines Simple Network 
Management Protocol (SMNP) objects for managing RTP systems. This work is 
produced by the Audio Video Transport (AVT) Group of the Internet Engineering Task 
Force (IETF) (Baugher, et al., 99) as broad guidance for all applications collecting RTP 
statistics. This chapter describes some basic concepts of the RTP MIB and compares its 
attributes with the existing set of Java Media Framework used by the rtpMonitor 


application. 


B. NETWORK MANAGEMENT OVERVIEW 


A network management system is a collection of tools for networking monitoring 
and control, including hardware and software (Stallings, 97). The key elements of a 
network management system are: 

e Management station — the interface to the network manager. 


e Agent — responds to requests for information and for taking actions. Typically, 
the agent software is installed in routers, bridges, hubs and hosts. 


e Management information base (MIB) — represents a collection of objects (data 
variables) managed by agents. 


e Network management protocol — links the management station with the 
agents. 


The Simple Network Management Protocol (SNMP) is the most widely 


management protocol in use for TCP/IP networks. SNMPv2 (version 2) is described in 
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RFC 1901 (Case, et al., 96). SMNP include mechanisms for retrieving data from agents, 


set values of objects on agents, and notify the management station of significant events. 


Cc. RTP MIB DESCRIPTION 


RTP agents running this MIB can be either RTP hosts (end systems) or RTP 
Monitors. The objective is to collect statistical data about RTP sessions and its streams, 
for diagnostics and management purposes. Each agent maintains a MIB that can be 
queried by a Manager. Only the last updated statistic is stored in the MIB. 

RTP MIB has three tables: 

e rtpSessionTable — contains objects that describe active sessions at the 
host, intermediate system or monitor. There is an entry in this table for 
each RTP session on which packets are being sent, received and/or 
monitored. 

e rtpSenderTable - contains information about senders of the RTP session. 
RTP sender hosts must have an entry in this table for each stream being 
sent, but RTP receiving hosts do not have to maintain this table. RTP 
Monitors must create an entry for each observed stream. 

e rtpRevrTable - contains information about receivers of the RTP session. 
RTP receivers must create an entry in this table for each received stream. 


RTP senders do not have to maintain this table. RTP monitors must have 
an entry for each pair sender/receiver in the sessions being monitored. 


D. COMPATIBILITY WITH JMF STATISTICS 


Appendix E is a table that compares the fields in the RTP MIB tables with the 
JMF statistics used by RTPMonitor. This comparison has two objectives: 
e Detect what MIB statistics are not supplied by JMF. If JMF does not supply 
all the required MIB data, an RTP MIB agent can not be implemented using 
JMF. 


e Detect what JMF statistics are not part of RTP MIB. Some of the JMF 
statistics can be added to the RTP MIB. 
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The comparison was sent to the JMF and IEFT-AVT mailing lists. The comments 
made by Bill Strahm, one of the authors of the RTP MIB Internet Draft are included in 
the table of Appendix E. Sun Microsystems software engineers have not replied with any 


comments. 


E. SUMMARY 


The Real-time Transport Protocol (RTP) Management Information Base (MIB) 
consists of a new Internet-Draft proposed by the AVT group of the IETF to be applied in 
RTP network management with SNMP. 

A number of significant differences were found between JMF 2.0 (Sun, 99) and 
the RTP MIB (Baugher, et al., 99). Further work will need to be performed by one or 


both organizations to resolve these discrepancies. 
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VU. EXPERIMENTAL RESULTS 


A. INTRODUCTION 


This chapter presents the experimental results achieved with the rtpMonitor 
application and describes problems faced during the testing phase. Furthermore, this 
chapter presents the work on an RTP header for the Distributed Interactive Simulation 


(DIS) protocol (IEEE, 95). 


B. TEST RESULTS 


The Java application rtpMonitor, described in Chapter V, was tested using the 
versions 1.1.7, 1.2.1 and 1.2.2 of the Java Development Kit (JDK), in combination with 
versions 1.0, 2.0 Early Access, and 2.0 Beta of the Java Media Framework. JMF Beta has 
three subversions available: 

e Pure Java: includes binaries written entirely in the Java programming 

language that can be installed on any operating system supported by the Java 


platform. 


e Solaris Performance Pack: an optimized version for the Solaris platform that 
includes binaries for this operating environment. 


e Windows Performance Pack: an optimized version for the Windows platforms 
that includes binaries for this operating environment. 


rtpMonitor was tested only in Windows NT platforms using the Windows 
Performance Pack. The program was tested in all its functionality, with special emphasis 
on the recording capabilities. It proved to be robust, running continuously for the 
maximum allowed session duration (one week) several times. It has generated correct 


output files of more than 40 Mbytes for a single session. 
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eC OBSERVED PROBLEMS 


Several errors (1.e. software bugs) were detected in JMF 1.0 through the 
development of rtpMonitor. The following errors were reported in the JMF mailing list 
and were corrected in JMF2.0 Early Access: 

e lhe number of lost PDU in the stream data was usually wrong. It returned a 
high number of lost PDU, even greater than the actual number of packets sent 
by the source. 

e When anon-participating option had been selected the information about the 
active and passive participants was inconsistent. Usually no participants were 
presented even though they might have existed. 


e Individual video windows could not be closed. 


e After a session had been stopped and a new session had been initiated, the 
global statistics about the previous session were still being considered. 


In JMF 2.0 Early Access and JMF 2.0 Beta, the only observed error is related to 
the Cumulative Number of Packets Lost (Packets Lost in the Feedback Area) which 
returns wrong values after some time. This problem has been reported to Sun's JMF-bugs 
e-mail box (jmf-bugs@sun.com) and to Sun’s JMF-interest mailing list 


(jmf-interest@java.sun.com). 


D. EXTENDING DIS-JAVA-VRML PDU HEADER 


Protocol Data Units (PDU) currenty used by the vrtp protocol (Brutzman, 99) are 
based on the Distributed Interactive Simulation (IEEE, 95) standard. As the vrtp 
protocol intends to use the Real-Time Transport Protocol as the transport protocol, an 
RTP Header should be added to the existing DIS PDU. Although such a modification is 
no longer strictly compliant with DIS over-the-wire formats, it nevertheless provides and 


interesting opportunity for research and testing. 
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As a product of this thesis, a new Java class for extending the DIS PDU with RTP 
header information was created. This class is specifically designed to be part of the DIS 
package (mil .nps.navy.dis) used by the DIS-Java-VRML application, a component 
of the vrtp protoco] (Brutzman, 99). This class was named RtpHeader. Appendix F 
contains the RtpHeader Javadoc and Appendix G contains the RtpHeader source code. 

The RtpHeader class was briefly tested during the period of this thesis. Client 
software automatically discriminates among DIS PDUs with and without RTP headers. 


This is an excellent result. Further testing 1s required as a future work. 


E. SUMMARY 


The rtpMonitor application has successfully been tested with different versions of 
the Java Development Kit (JDK) and Java Media Framework (JMF). The program 
proved to be robust in several long-term monitoring sessions. Despite most JMF 
problems have been solved in version 2.0 Early Access, additional fix should be done. 

A new header for the Protocol Data Units (PDU) of the DIS-Java- VRML 


application was developed and initial test produced excellent results. 
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VUl. CONCLUSIONS AND RECOMMENDATIONS 


A. RESEARCH CONCLUSIONS 


The RTP monitor application has been successfully implemented using Java 
Media Framework (JMF). The monitor can be applied to help detect problems in RTP 
based multicast session by adding statistics recording capabilities, not available in the 
existing individual conference applications. The presentation of RTP statistics and 
feedback reports in a single screen is also a good feature for on-line monitoring. The 
RtpMonitor class package can be used by future RTP applications, as a simple means to 
record statistics with no direct access needed to JMF resources. This is an important new 
capability, since core Java classes do not provide access to IGMP (Deering, 89) packets 
on the network layer and would otherwise require additional programming of native code 
(e.g. C source code) via the Java Native Interface (JNI) (Sun, 99) to achieve RTCP 


capabilities. 


B. RECOMMENDATIONS FOR FUTURE WORK 


A number of excellent opportunities for future work are now possible. 


I; Participants Information 


RTCP Session Description Reports convey several data about each participant, as 
name, e-mail and tool being used. This information can be added to RTPMonitor for 
presentation and recording purposes. JMF contains the necessary classes and methods to 


set, send and retrieve this data. 
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1a Extensible Markup Language (XML) Recording 


rtpMonitor records the RTP session data as text files. The use of Extensible 
Markup Language (XML) (Word Wide Web Consortium, 99) for recording the data 
would allow an easier data retrieval. Java-based XML parsers are available and can 
provide an efficient way to read and write Java data structures as XML documents and 


vice-versa. 


3. Recorded Data Analysis and Presentation 


A tool to retrieve remotely (or receive) the rtpMonitor output file statistics is 
needed. It should be able to present the each individual data in a graphical format, 
covering a period of time defined by the user. Again XML provides browsing options for 


automatic presentation of such data by any web browser. 


4. Session Description Protocol (SDP) Reception 


The Session Description Protocol (SDP) is intended for describing multimedia 
sessions for the purposes of session announcement, session invitation, and other forms of 
multimedia session (IETF, 98). In rtpMonitor the user has to enter the RTP session 
address. Future work needs to add SDP reception capability to simplify starting a 
monitoring session and allowing the detection of ongoing sessions, 1n addition to the 


current approach. 


5: RtpMonitor Activation from SDR 


Session Directory (SDR) is a session directory tool designed to allow the 


advertisement and joining of multicast conferences on the MBone (UCL, 99). It is 
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possible to launch external application from SDR by modifying some of the SDR 


configuration files. Providing a plug-in file to SDR might result 1n an easier activation of 


the rtpMonitor application. 


6. JMF Extensibility for Other Media 


Java Media Framework (JMF) distribution comes with a set of concrete classes to 
implement the RTP transmission, reception and playback of audio and video. However, 
the extension of JMF to support other types of media is highly desirable. An important 
area of future work is the implementation of simulation data transmission and reception 
using the RTP API of Java Media Framework. This work will have direct application in 


the vrtp streaming behaviors stack. 


ae Automated Network Monitoring of RTP Streams for VRTP. 


The rtpMonitor class library can be integrated with the vrtp protocol to allow the 
automatic monitoring capability in vrtp sessions. For this purpose the rtpMonitor library 
must be updated to support transmission statistics and direct activation by vrtp 


components. This is a good area of study for agent-based network monitoring, diagnosis 


and problem correction. 


8. Design Patterns Course in Computer Science Curriculum 


Design Patterns study helps to solve recurring design problems by using common 
adopted solutions. Furthermore, the Design Patterns nomenclature provides a precise 
way of communicating design ideas among software engineers. The inclusion of a 


Design Patterns course in the Computer Science and MOVES Curricula is highly 


recommended. 
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APPENDIX A. PREPARING UML DIAGRAMS USING RATIONAL ROSE 


UML Diagrams Preparation 


Rational Rose version 981 can represent the following types of UML diagrams: 
e Use Case Diagrams 

e Class Diagrams 

e Collaboration Diagrams 

e sequence Diagrams 

e Component Diagrams 

e Deployment Diagrams 


The program is capable of handling different models (projects), each model being a set of 
basic components (classes, interfaces, actors and associations) and diagrams. For better 
visualization the project is organized in a tree-like structure having the following main 
branches: 
e Use Case View — usually contains the Use Case Diagrams and actors 
components. 
e Logical View — usually contains the Class Diagrams, Collaboration Diagrams 
Sequence Diagrams, Class Components and Interface Components. 
e Component View — contains the Component Diagrams. 
e Deployment View — contains a Deployment Diagram. 


To create a new diagram, the user has to select the branch he wants the diagram in, click 
with the mouse right button and select what type of diagram is to be created. A new blank 
diagram is shown and the components can be created and placed on the diagram by 
selecting the appropriate component in a tool bar and clicking in the place the component 
must be positioned in the diagram. Depending on the type of the component different 
information should be provided. By right clicking on a component a pull-down menu is 
shown and the user can invoke the component specification as long as the option-setting 
feature. 


Reverse Engineering of Java Source Code 
Reverse engineering is the process of creating or updating a model by analyzing Java 


source code. As Rational Rose reverse engineers each .java or .class file, it finds the 
classes and objects in the file and includes them in the model. 


18 


To reverse engineer all or part of a Java application: 


Ih If you are updating an existing model, open the model, otherwise create a new 
model. 

i On the Tools menu, point to Java, and then click Reverse Engineer. 

SF From the directory structure , select the classpath setting and folder where the 


files you’re reverse engineering are located. (If the list is empty, check your classpath. 
For details, see How Rose J Models the Classpath and Extending the Java Classpath .) 


4. Set the Filter to display the type of the Java files whose code you want to reverse 
engineer (.java or .class files). 


Ds Do one of the following to place the Java files of the type you selected into the 
Selected Files list: 


e Inthe File list box, select one or more individual files and click Add. 
e Click Add All 


e Click Add Recursive 


6. Select one or more files in the Selected Files box or click Select All to confirm the ~ 


list of files to reverse engineer. 


te Click Reverse to create or update your model from the Java source you specified. 
An error dialog displays, if any errors occur during reverse engineering. 


8. Check the Rose Log for a listing of any errors that might have occurred. 


The procedure above is described in the Rational Rose Help. An additional requirement 
for reverse engineering of Java code is that the JDK API definitions must be available by 


adding the file ¢;\jak1.2.2\jre\lib\rt.jar to the classpath. 


Using the reverse engineering feature, Rational Rose will import from Java code all 
classes, interfaces and associations, but the diagrams are not automatically generated. 
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APPENDIX B. RTPMONITOR USER MANUAL 


rtpMonitor User Manual 
version 1.0 


Contents: 


1. Execution 

2. Defining a session 

3. Session Bookmarks 

4. Preferences 

5. Starting a session 

6. Statistics 

7. Stopping a session 

8. Recording monitoring data 

9. Using the monitor without GUI 

10. Wrong behaviors and results (bugs) 


11. Running the program in other directory 
12. Reinstallation recommendations 


V2 


1. Execution 


a) In the command line type: 


Cd veep \rtpMonsGcor 
java org.web3d.vrtp.rtp.RtpMonitor 


b) or run the batch file rtpMonitor.bat in the c:\vrtp\rtpMonitor directory. There is a 
Windows shortcut to this file in the same directory. This shortcut can be copied to the 
Desktop to create an icon for the rtpMonitor program. 

Using this call with no arguments the GUI version of the program will be executed. The 
following window is presented: 





Session Name 





Global Statistics 


Stream 





Total Bytes a ae Bad SDES Packets a. 
Total Packets | Bad BYE Packets | : 


= Lost PDUs | 
RTCP Packets | Local Collisions | —— 
— Processed PDUs | 
SR Packets Remote Collisions | 


| —— MisOrderedPDUs[ SCS 
Bad RTP Packets | a Looped Packets —_— 7s 
ie ) Invalid PDUs 

Bad RTCP Packets | Failed Transmission| re 
Duplicate PDUs a 

Bad SR Packets | Unknown Type | Saran 

Bad RR Packets | 

Feedback Reports 


Active Participants Passive Participants Username Fraction Lost Jitter Packets Lost 














80 


Defining a session 


In the session box enter the session address/port/tt] as in the example below: 
rtp://224.2.125.60:55690/127 


where : 


Multicast IP address: 224.2.128.60 
RTP port: 55690 
c(t Wh ee bee 


3. Session Bookmarks 
As an option to writing the session address, it is possible to select a session bookmark. 


The program already comes with some pre-defined session bookmarks. Bookmarks can 
be added and deleted. 





Preferences Help 
Select 





Ses ¥ | a ani aaa Session Name Start | Stop | 
Global Statistics 


Tota! Bytes [ Bad SDES Packets | Stream | oe = 7] 


Total Packets | Bad BYE Packets | Change| 
= Lost PDUs | 
RTCP Packets | Local Collisions | oe 


Processed PDUs | 
SR Packets | Remote Collisions | 
MisOrdered PDU | 
Bad RTP Packets | Looped Packets | _ ‘ : 


Bad RTCP Packets | FailedTransmissionf === invalid POUs 
Duplicate PDU 
BadSR Packets | Unknown Type lla p od 


Bad RR Packets | 
Feedback Reports 


Active Participants Passive Participants Username Fraction Lost Jitter Packets Lost 


a 





8] 


The option "Select" displays a window with the pre-defined session bookmarks. Click 
over the desised session to select it. 


Select Bookmark 








Capitol GMU (audio). . 

Nasa TV fromH@ (ideo)  —s_—| 
Nasa TY from HQ (audio) . 
Places all over world (video) 


The option "Add" allows the insertion of a new session bookmark. This option is enabled 
only when a session has been started. The session address 1s the session of the current 
session. The session name will be the bookmark name. 


ee AN et te (me ae 


fe Add shore) qiiteli 4 


Sd 






Session Address: rtp:/224.2.220.5:56414/127 





Session Name ~ 


Add | 


Cancel | 
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The option "delete" allows the deletion of a bookmark. A window with the existing 
bookmarks will be presented and the user can select the bookmark to be deleted and click 
the "Delete" button. 











ey Delete Bookmark xX] 


Dis-Java-Vrml (video) 
Dis-Java-¥rml (audio) 
DIS-Java-VRML (DIS PDUs) 
Capitol GMU (video) 

Capitol GMU (audio) 

Nasa TY from HQ (video) 
Nasa TY from HQ (audio) 
Places all over world (video) 








Pete cc avasecccccostuessoesetete 






2 a a 
ae peg Rt Oe aE Pe 
$ 


Cane 







el 





“ petete | 


4. Preferences 


Before starting to monitor a session, the user should set up the program preferences. The 
menu "Preferences" allows the verification and modification of the program preferences. 
Selecting Preferences -> Modify the following window will be presented: 


[Y Send RTCP packets 

[Y Play incoming media 

[VY Record statistics 

Record Interval(sec) 30.0 
Presentation Interval(sec) [5 


Monitoring Period [1 hour | 


ee et ee ee nnn tee 


External viewer. 


[*cAProgram Files\PFE Programmers File Edito 
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The options are: 


Send RTCP packets checkbox: defines if the monitor will participate in the 
session, sending RTCP packets. 

Play incoming media checkbox: defines if the monitor will play the received 
streams (audio or video). For video, a new playing window will be created for 
each active participant stream. For audio, only one playing window will be 
created. 

Record statistics checkbox: defines if the monitor will record the session statistics 
in files. 

Record Interval textbox: the user can enter the interval between recorded data, in 
seconds (default = 30 sec). 

Presentation Interval textbox: the user can enter the interval between data updates 
on screen, in seconds ( default = 5 sec). 

Monitoring Period choicebox: allows the user to specify the duration of the 
monitoring session. After the time is over the program will exit automatically. 
The maximum allowed duration is one week (default = 1 hour). 

External viewer textbox: defines an external text editor that will be called to 
present the output files generated by the monitor ( default = MS Windows 
Wordpad ). 


The selected preferences will be saved on file and will be available in the next time the 
program is executed. 


5. Starting a session 


After entering the session address and the desired option, the user can click on the start 
button to start a monitoring session. If the supplied session address is invalid or if any 
other problem in establishing a session occurs an error message will be displayed in the 
feedback text area. 


6. Statistics 


The program displays the following types of information about the session: 


Global statistics: general information about the whole session. 

Active Participants: the username of the participants actually sending data 
Streams. 

Passive Participants: the username of the participants that do not send any stream. 
Stream: the stream that is currently being monitored. That stream can be changed 
in a session with multiple incoming streams by clicking in the "change” button 
and selecting another stream in the stream selection box. 

Feedback: that display area presents the RTCP feedback data related to the 
selected stream. Usually the participants in the session send feedback data about 
all streams. 
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7. Stopping a session 


Clicking the "stop" button can stop a session. After stopping a session, the user is allowed 
to change the session address and preferences before starting monitoring again. 


8. Recording monitoring data 


A new subdirectory is created for each session address, with the following name: 
session []Paddress] port [port number] 


Inside this subdirectory several files will be generated and updated during a recording 
session. They are: 

e statisticsHeader.txt: contains the description of the fields being stored. 

e statisticsLastFiveMinutes.txt: contains the last five minutes block of statistics. 

e statisticsPreviousFiveMinutes.txt: contains the previous five minutes block of 
Statistics. 
statisticsLastHour.txt: contains the last hour block of statistics. 
statisticsPreviousHour.txt: contains the previous hour block of statistics. 
statisticsDateMM-DD-YYYY: contains statistics taken in described date. 
statisticsLastReport.txt — contains the last single report. 


There is also a file called LastDateRef.txt, which contains the last monitoring date for 
that session. It is possible to see some of these files using the menu "File". 
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cf | 


a4 RtpMonitor 


Resellers kin lee : “3 wr amae ; & - + 
mere pa attains pertain pete til anil 0 cee Sottero aaet e a netie: —oran A Ae Lie A a NOIRE Corer to eet oe 













Last five minutes | : 
Orotias icteies 2.203.37:60068/1 27 Session Name | Nasa TV from HQ (video) Start | Ston | 
Last hour 


Global Statistics 


Bad SDES Packets | — Stream 
Bad BYE Packets | 


Local Collisions 





Lost PDUs 


Processed PDUs 


MisOrdered PDUs - 


SR Packets Remote Collisions 


Bad RTP Packets | _ Looped Packets 


Bad RTCP Packets | Failed Transmission| Invalid PDUs —— 
. Duplicate PDUs | 









Bad SR Packets Unknown Type 
Bad RR Packets 
Feedback Reports 


Active Participants Passive Participants Username Fraction Lost Jitter Packets Lost 





The external viewer defined in the preferences will be called to present the output files. 
These options can be executed during a monitoring session. Below is an example of the 
Last five minutes file using MS Windows WordPad editor as an external viewer. The 
format of the data is stored in the file statisticsHeader.txt, also shown below. 
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iS statisticsLastFiveMinutes.txt - Notepad 
Ede Edit Search Help ee 


D1 10:25:27 9 8 1 5651647 6334 358 27 86060666686 8 8 B * 
D2 ellery@131.182.168.256 1564161648 963 5976 6 GO B ti 
D3 joel ja@128 .223.214.27 1569838982 1564101640 6.6 8 6 

D3 Bbrutzman@accelerate 4285065786 1564161646 6.89396625 863 3826 
D3 ellery@131.182.18.258 15641601648 1564161648 6.6 1 8 

D3 miyake@128 .223.83.29 1568747521 1564161646 6.6 46 B 

D3 mmei@141.78 .3.242 398571242 1564161646 6.0546875 17478 6 

D1 18:25:57 9 8 1 6893963 7723 428 33 6868868666686 6 6 § 

D2 ellery@131.182.18.258 15641801648 967 7296 6 8 B 

D3 joelja@128 .223.214.27 1569838982 1564161646 6.6 8 G6 

D3 brutzman@accelerate 4285665786 1564161646 6.69375 918 36487 

D3 ellery@131.182.16.256 1564161646 1564161648 6.61 6 

D3 miyake@128 .223 .83.29 1568747521 1564161646 6.6 42 6 

D3 mmei1@141.78 .3.242 398571242 15641816468 86.1615625 17614 6 

D1 10:26:27 9 8 1 82256068 9184 497 38 66666666 6 868 

D2 ellery@131.182.18.2568 1564161646 1669 8688 6 6 6 

D3 joelja@128 .223.214.27 1569838982 15641616460 6.68 8 8B 

D3 brutzman@accelerate 4285665786 1564161646 60.6546875 1623 2953 
D3 ellery@131.182.168.256 15641616468 15641601646 6.6 1 8 

D3 miyake@128 .223 .83.29 1568747521 1564161648 6.6 44 6 

D3 mmei1@141.78 .3.242 398571242 1564161648 8.88984375 17736 6 

D1 16:26:57 9 8 1 9499537 160587 556 43 66666686 86 6 6 6 

D2 ellery@131.182.168.256 15641616468 1214 16631 6 6 8 

D3 joel ja@128 .223 .214.27 1569838982 1564161640 6.6 8 8 

D3 brutzman@accelerate 4285665786 15641616468 6.615625 1643 3332 
D3 ellery@131.182.18.256 1564161646 1564161648 6.61 9 

D3 miyake@128 .223.83.29 1568747521 1564161646 6.6 44 

D3 mmei1@141.78.3.242 398571282 15641616468 6.608984375 17866 9B 

D1 10:27:27 9 8 1 180912065 12114 627 47 8686666 6 6 6 8 

D2 ellery@131.182.168.256 1564161646 12360 11488 6 6 6 

D3 joel ja@128 .223.214.27 1569838982 1564161646 6.6 8 6 = 


a 
s eS 0% oe 


H2 CNAME SSRC LostPDU ProcessedPDU MisorderedPDU InyvalidPDU DuplicatePDU 
H3 CNAME FromSSRC AboutSSRC FractionLost PacketsLost Jitter 





Each line of data is preceded with a header indicator (D1, D2 or D3), which indicates the 
line of the statisticsHeader file that contains the description of the data being stored (H1, 
H2 or H3). 
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9. Using the monitor without GUI 


The program can be executed without the GUI (no statistics are presented) by passing the 
session address and options data via the command line. The format is: 


java org.web3d.vrtp.rtp.RtpMonitor sessionAddress [options] 
The options are: 
-part : the monitor participates in the session (sends RTCP packets as a receiver in 
the session) 
-play : the monitor play streams 
-record : the monitor records statistics 


-1 nnn : nnn defines the recording interval in seconds (default 30s) 


-€ ppp : ppp defines the monitoring duration in hours (default: 168 hours = 1 
week) 


-help: displays the options on the console. 


Example: java org.web3d.vrtp.rtp.RtpMonitor 
rtp://224.120. 67. 46/64542/127 -play -record -e 24 


Action: runs the program for monitoring the session in the IP address 224.120.67.46, 
port 64542, with TTL = 127. It does not participate in the session, but plays the incoming 
streams and records statistics on files. The recording interval will be 30 seconds and the 
monitoring duration will be 24 hours. 

To stop the program press <Ctrl-C-> 


10. Wrong behaviors and results (bugs) 


Several early bugs were related to JMF1.1 and were corrected in JMF2.0 Early Access. A 
new bug was observed in JMF 2.0 Early Access: the Cumulative Number of Packets Lost 
( Packets Lost in the Feedback Area ) is returning wrong values after some time. This 
problem was reported to Sun's JMF-bugs list in 08-Jun-1999, but it is still present in 
JMF2.0 Beta. 
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11. Running the program in other directory 


To run the program in another directory copy the files "bookmarks.txt" and "Header.txt" 
to the new directory. Then run rtpMonitor from this directory. 
Example: 

Cony bookmarks, Xt cs Mydqir 

copy Header.txt c:\Mydir 


Ca AMyair 
Javea OFfoO.Webpsa.Vrep.rep,nepMonitor 


12. Reinstallation recommendations 


In order to continue using the previous bookmarks and preferences, the files 
“pookmark.txt" and "preferences.txt" in the directory "\vrtp\rtpMonitor" should be saved 
and restored after the new installation. 


To reinstall the program it is recommended the deletion of the following directories: 
- \vrtp\javadoc\rtpMonitor 
- \vrtp\org\web3 d\vrtp\rtp 
- \vrtp\rtpMonitor 
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APPENDIX C. RTPMONITOR JAVADOC 
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Package Class Tree Deprecated Index Help 
PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES 


Package org.web3d.vrtp.rtp 


Class Summary 
About A Dialog to display information about the program e.g. 
AddBookmark The Dialog to add a session bookmark. 


. This class is used to set a frame/dialog as not visible when the 
Close Window close icon 1s clicked. 


DeleteBookmark A Dialog to delete a session bookmark. 


nlacaeel: A class used by RtpMonitor objects to periodically launch 
their showStats methods (screen updates). 




















FileCatalo A class used by RecordTask objects to organize statistics in 
— several files ( five minutes, hour, and day ). 


ModifyPreferences A Dialog to display and modify the program preferences. 


A class used by RtpMonitorManager objects to write the 
RecordTask Statistics periodically to disk. 


: A class that represents necessary information to define an 
RtpMediaLocator RTP session, as address, port and TTL. 


RtpMonitor The RtpMonitor Application. 


Rin \ienitarGonimanditine * a used to start a RTP monitor from command line 


A class that encapsulates all operations necessary to start a 
new monitoring session, play its streams, and record statistical 
data. 






| 











i 














RtpMonitorManager 


RtpPlayerWindow ) 









This class is used to create a window for playing an 
audio/video stream. 

RtpUtil A class with some RTP utilities (static methods) 
SelectBookmark A Dialog to select a session bookmark. 







Package Class Tree Deprecated Index Help 


PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES 
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Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 








org.web3d.vrtp.rtp 


Class About 


java.lang.Object 
| 


+--jJava.awt.Component 


+--java.awt.Container 


+--java.awt.Window 


| 
+--java.awt.Dialog 


| 
+--oOrg.web3d.vrtp.rtp.About 





public class About 
extends java.awt.Dialog 


A Dialog to display information about the program e.g. version, date 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 


Fields inherited from class Java.awt.Component 


BOTTOM ALIGNMENT, CENTER_ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP ALIGNMENT 7 


Constructor Summary 


About (java.awt.Frame parent) 
Constructor. 


Methods inherited from class java.awt.Dialog 


addNotify, dispose, getTitle, hide, isModal, isResizable, setModal, 
setResizable, setTitle, show 





vs. 


Methods inherited from class java.awt.Window 


addWindowListener, applyResourceBundle, applyResourceBundle, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit, getWarningString, isShowing, pack, postEvent, 
removeWindowListener, setCursor, toBack, toFront 


Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentAt, 
getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, 
getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, 
Hayout, list, list, locate, minumumsize, paine, painecomponemes: 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, removeNotify, setFont, setLayout, update, 
validate 


Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addInputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, 
printAll, remove, removeComponentListener, removeFocusListener, 
removeInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 


















































equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 





Constructor Detail 


- About 


public About(java.awt.Frame parent) 
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Constructor. 


Parameters: 
parent - the parent frame 
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org.web3d.vrtp.rtp 


Class AddBookmark 


java.lang.Object 


| 
+=--java.awt.Component 


| 
+--java.awt.Container 


+--java.awt.Window 


+--java.awt.Dialog 
| 
+--org.web3d.vrtp.rtp.AddBookmark 





public class AddBookmark 
extends java.awt. Dialog 
implements java.awt.event.ActionListener 


The Dialog to add a session bookmark. 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 


Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER_ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP ALIGNMENT 


Constructor Summary 


AddBookmark (java.awt.Frame parent) 
Constructor. 


_|Method Summary 
voidlfactionPerformed(java.awt.event.ActionEvent e) 
Takes action when buttons are selected. 
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Methods inherited from class java.awt.Dialog 


addNotify, dispose, getTitle, hide, isModal, i1sResizable, setModal, 
setResizable, setTitle, show 





Methods inherited from class java.awt.Window 













addWindowListener, applyResourceBundle, applyResourceBundle, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit, getWarningString, isShowing, pack, postEvent, 
removeWindowListener, setCursor, toBack, toFront 









Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentAt, 
getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, 
getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, 
avout, ~Llist, List,..lceate, minimumsi ze, paint, -painecommonents, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, removeNotify, setFont, setLayout, update, 
validate 


Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addInputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, lsEnabled, isFocusTraversable, 
isLightweight, lsOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, 

printAll, remove, removeComponentListener, removeFocusListener, 
‘|removeInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 


equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 
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AddBookmark 
public AddBookmark(java.awt.Frame parent) 
Constructor. 


Parameters: 
parent - the parent frame 


Method Detail 


actionPerformed 


public void actionPerformed(java.awt.event.ActionEvent e) 


Takes action when buttons are selected. 
Specified by: 
actionPerformed in interface java.awt.event.ActionListener 
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org.web3d.vrtp.rtp 


Class CloseWindow 


java.lang.Object 


| 
+--java.awt.event.WindowAdapter 


| 
+--org.web3d.vrtp.rtp.CloseWindow 





public class Close Window 
extends java.awt.event. WindowAdapter 


This class is used to set a frame/dialog as not visible when the close icon is clicked. 


Version: 
Lo 
Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


Method Summary 


voidiwindowClosing(java.awt.event.WindowEvent e) 
set frame/dialog as not visible. 


Methods inherited from class java.awt.event.WindowAdapter 


windowActivated, windowClosed, windowDeactivated, windowDeiconified, 
windowIconified, windowOpened 













Methods inherited from class java.lang.Object 


equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 


Constructor Detail 
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CloseWindow 


public CloseWindow ({ ) 


Method Detail 


windowC losing 
public void windowClosing(java.awt.event.WindowEvent e) 


set frame/dialog as not visible. This method is activated when the window is closed. 
Overrides: 
windowClosing in class java.awt.event. WindowAdapter 
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org.web3d.vrtp.rtp 


Class DeleteBookmark 


java.lang.Object 
| 


+--java.awt.Component 


| 
+--java.awt.Container 


+--java.awt.Window 


| 
+--java.awt.Dialog 


| 
+--org.web3d.vrtp.rtp.DeleteBookmark 





public class DeleteBookmark 
extends java.awt.Dialog 
implements java.awt.event.ActionListener 


A Dialog to delete a session bookmark. 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 


Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP ALIGNMENT 





Constructor Summary 


DeleteBookmark (java.awt.Frame parent) 


a 


Constructor. 






Method Summary 


ee 


Takes action when buttons are selected. 





actionPerformed(java.awt.event.ActionEvent e) 


10] 


Methods inherited from class java.awt.Dialog | 


addNotify, dispose, getTitle, hide, isModal, isResizable, setModal, 
setResizable, setTitle, show 


Methods inherited from class java.awt.Window 


addWindowListener, applyResourceBundle, applyResourceBundle, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit,..getWarningString, issnowing, Caex,. posemven:, 
removeWindowListener, setCursor, toBack, toFront 


Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentAt, 
getComponentCount, getComponents, getiInsets, getLayout, getMaximumSize, 












getMinimumSize, getPreferredSize, insets, invalidate, isAncestoroOf, 
layout, list, list,elecate mianimumSize, oaint, paint Componenes, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, removeNotify, setFont, setLayout, update, 
validate 





Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addIinputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeigh:, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, 
printAll, remove, removeComponentListener, removeFocusListener, 
removeInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 




























equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 
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DeleteBookmark 
public DeleteBookmark (java.awt.Frame parent) 
Constructor. 


Parameters: 
parent - the parent frame 


Method Detail 


actionPerformed 
public void actionPerformed(java.awt.event.ActionEvent e) 


Takes action when buttons are selected. 
Specified by: 
actionPerformed in interface java.awt.event.ActionListener 


Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 





103 


Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 





org.web3d.vrtp.rtp 


Class DisplayTask 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.DisplayTask 


public class DisplayTask 
extends java.lang.Object 
implements java.lang.Runnable 


A class used by RtpMonitor objects to periodically launch their showStats methods (screen 
updates). 


Version: 
1.0 
Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


DisplayTask (RtpMonitor mon, double interval) 
me“ ConSieten 


Method Summary 


” This method runs continuously calling the showStats methods of RtpMonitor in 
the proper presentation interval, until the RtpMonitor stops the session. 





Constructor Detail 


DisplayTask 


public DisplayTask(RtpMonitor mon, 
double interval) 
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Constructor. It creates a new thread of execution and calls the method run(). 
Parameters: 
mon - the RtpMonitor object that will be called back for screen updates. 
interval - the interval between screen data updates, in seconds. 


Method Detail 


run 


public void run{) 


This method runs continuously calling the showStats methods of RtpMonitor in the 
proper presentation interval, until the RtpMonitor stops the session. 
Specified by: 

run in interface java.lang.Runnable 
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org.web3d.vrtp.rtp 


Class FileCatalog 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.FileCatalog 





public class FileCatalog 
extends java.lang.Object 


A class used by RecordTask objects to organize statistics in several files ( five minutes, hour, 
and day ). 


This class writes to the file following files: statisticsLastFiveMinutes.txt, 
statisticsPreviousFiveMinutes.txt, statisticsLastHour.txt, statisticsPreviousFiveMinutes.txt, 
and statisticsDateMM-DD-YYYY.txt. 


Version: 
1.0 
Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 





Constructor Summary 


FileCatalog(java.lang.String pref) 
Constructor. 


Method Summary 


static void] concatenate (java.lang.String filel, java.lang.String filed) 
Utility to concatenate two files. 


java.lang.String| retrieveDateRef () 
This method retrives a date in a string format from the file 
statisticsLastDateRef.txt. 


void| saveDateRef (java.lang.String dater) 
This method saves in a file a date in a string format. 
) 


void|update (java.util.Calendar time 
Method that will update the files, transfering data from 
statisticsLastReport.txt to the appropriate files. 
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Methods inherited from class java.lang.Object 


equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 


Constructor Detail 


FileCatalog 





public FileCatalog(java.lang.String pref) 
Constructor. It checks if there are previous data from the same session and transfers 


these data to the correct statisticsDateMM-DD_YYYY.txt file. Then it clears all "five 
minutes" and "hour" data files. 


Parameters: 
pref - a string containing the directory where the data must be written 


Method Detail 


update 


public void update(java.util.Calendar time) 
Method that will update the files, transfering data from statisticsLastReport.txt to the 
appropriate files. 


Parameters: 
time - the current time as a Calendar object. 


concatenate 


public static void concatenate (java.lang.String filel, 
java.lang.String file2) 


Utility to concatenate two files. 

Parameters: 
file - the first file ( filel <- filel + file2 ). If filel does not exits this method 
will copy file2 to filel. 


file2 - the file to be appended to file]. 


' saveDateRef 


public void saveDateRef (java.lang.String dater) 


107 


This method saves in a file a date in a string format. It is used for save the date of the 
last report. The file name is statisticsLastDateRef.txt. 
Parameters: 


dater - a string representing a date as DD-MM-YYYY 





retrieveDateRef 


public java.lang.String retrieveDateRef () 


This method retrives a date in a string format from the file statisticsLastDateRef.txt. 
Returns: 


string representing a date as DD-MM-YYYY 
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org. web3d.vrtp.rtp 


Class ModifyPreferences 


java.lang.Object 


| 
+--java.awt.Component 


| 
Pe avea vawe -CONLa@ner 


| 

+--java.awt.Window 
| 
+--jJava.awt.Dialog 


| 
+--org.web3d.vrtp.rtp.ModifyPreferences 





public class ModifyPreferences 
extends java.awt. Dialog 


A Dialog to display and modify the program preferences. 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 









Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
'|TOP_ ALIGNMENT 
Constructor Summary 


ModifyPreferences (java.awt.Frame parent) 
Constructor. 
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Method Summary 


disableInput () 





Disables the GUI input elements 


void] enableInput () 
Enables the GUI input elements 
void! savePreferences () 
Saves the preferences in the file preferences.txt 


Methods inherited from class java.awt.Dialog 






addNotify, dispose, getTitle, hide, isModal, isResizable, setModal, 
setResizable, setTitle, show 


Methods inherited from class java.awt.Window 











addWindowListener, applyResourceBundle, applyResourceBundle, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit;, getWarningstring, isShowing, pack, postEven:, 

removeWindowListener, setCursor, toBack, toFront 


Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentaAt, 
getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, 
getMinimumSize, getPreferredSize, insets, invalidate, isAncestoroOf, 
layout, list, list, locate; minimumSize, paint, palneeomponenes, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, removeNotify, setFont, setLayout, update, 
validate 


Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addInputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, preparelImage, 
printAll, remove, removeComponentListener, removeFocusListener, 
removelInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
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setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 














equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 


ModifyPreferences 
public ModifyPreferences (java.awt.Frame parent) 
Constructor. 


Parameters: 
parent - the parent frame 


Method Detail 


enableInput 


public void enableInput() 


Enables the GUI input elements 





disableInput 


public void disableInput () 


Disables the GUI input elements 


savePreferences 


public void savePreferences () 


Saves the preferences in the file preferences.txt 
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org.web3d.vrtp.rtp 


Class Record Task 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.RecordTask 


public class RecordTask 
extends java.lang.Object 
implements java.lang.Runnable 


A class used by RtpMonitorManager objects to write the statistics periodically to disk. It is 
created as a separate thread that waits for a fixed period of time after writing data to disk. 


This class writes data to the file called "statisticsLastReport.txt", that contains only the last 
single report. The FileCatalog class is actually responsible for transferring the data to the file 
"statisticsLastFiveMuinutes.txt" and other files. 


Version: 
1.0 


Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


RecordTask (RtpMonitorManager mon, double recInterval) 


eee 


Constructor. 


Method Summary 


voidilexit ( 


Resets a flag that is checked each time the thread associated with this object is 
awaken after the wait command, causing the thread to end. 


run () 
Starts executing the recording and waiting until the recording interval is over, in 
a loop, until the "exit" method is called. 


Methods inherited from class java.lang.Object 





equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 
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Constructor Detail 


Record Task 


public RecordTask (RtpMonitorManager mon, 
double recInterval) 


Constructor. It creates the session directory where the stats files will be written. Also it 
creates a FileCatalog object that will organize the data in several files (five minutes, 
hour and day). 


Parameters: 
mon - the RtpMonitorManager that manages the monitoring session. 


recInterval - the interval between statistic samples, in seconds. 


Method Detail 


exit 


Public void exit() 


Resets a flag that is checked each time the thread associated with this object is awaken 
after the wait command, causing the thread to end. 





run 


PUubltcevolca run () 


Starts executing the recording and waiting until the recording interval is over, in a loop, 
until the "exit" method 1s called. 
Specified by: 

run in interface java.lang.Runnable 
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org.web3d.vrtp.rtp 


Class RtpMediaLocator 


java.lang.Object 


| 
+--javax.media.MediaLocator 


| 
+--org.web3d.vrtp.rtp.RtpMediaLocator 


public class RtpMediaLocator 
extends javax.media.MediaLocator 


A class that represents necessary information to define an RTP session, as address, port and 
ae: 


Version: 
eRe, 
Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


See Also: 
Serialized Form 


Field Summary 


Static int} TTL UNDEFINED 
Defines the value of TTL if not provided. 


Constructor Summary 


RtpMediaLocator (java.lang.String locatorString) 
Constructor. 


Method Summary 
java.lang.String| getSessionAddress () 
Returns the RTP Session address 
int|getSessionPort () 
Returns the RTP session port. 
int} getTTL ( ) 
Returns the session Time-to-live. 
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Methods inherited from class javax.media.MediaLocator 


getProtocol, getRemainder, getURL, toExternalForm, toString 


Methods inherited from class java.lang.Object 





equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 





Field Detail 


TTL UNDEFINED 
Public Static final int TPE. UNDEEINED 


Defines the value of TTL if not provided. 


Constructor Detail 


RtpMediaLocator 


public RtpMediaLocator (java.lang.String locatorString) 
throws java.net.MalformedURLException 


Constructor. 

Parameters: 
locatorString - Describes the session. It should have the following format: 
rtp://address:port[/ttl}] , where: 
address -> multicast address of the rtp session 


port -> port number 


ttl (optional) -> time-to-live 


Method Detail 


getSessionAddress 


public java.lang.String getSessionAddress () 
Returns the RTP Session address 


Returns: 
String form of the RTPSession address 


Its 


getSessionPort 


pubIge int getSessionrorc, 


Returns the RTP session port. 
Returns: 
RTP session port 





get TTL 
public int Getrag 
Returns the session Time-to-live. 


Returns: 
time-to-live(TTL) 
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org.web3d.vrtp.rtp 


Class RtpMonitor 


java.lang.Object 
| 


+--jJava.awt.Component 


| 


+--java.awt.Container 


| 
+--java.awt.Window 


+--java.awt.Frame 


| 
+=-org.web3sd.vrtp. rtp. RtpMonitor 





public class RtpMonitor 
extends java.awt.Frame . 
implements java.awt.event.ActionListener, java.awt.event.ItemListener 


The RtpMonitor Application. 
This class is a frame that implements the RtpMonitor GUI. 
If any command line argument is passed the RtpMonitorCommandLine class is called instead. 


Version: 

10 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 


Fields inherited from class java.awt.Frame 


CROSSHAIR CURSOR, DEFAULT CURSOR, E RESIZE CURSOR, HAND CURSOR, ICONIFIED, 
MOVE _ CURSOR, NORESIZE CURSOR, NE _RESIZE VGURSOR; NORMAL, NW. RESIZE CURSOR, 
5 RESIZE_ CURSOR, SE RESIZE UCURSOR, SW RESIZE CURSOR» TEAL» CURSOR, 

We MRE SLGE | CURSOR, WAIT _CURSOR 


_|Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER_ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP_ALIGNMENT 7 
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Constructor Summary 


RtpMonitor () 
Constructor. 


Method Summary 
voidjactionPerformed(java.awt.event.ActionEvent e) 
Takes action when buttons are selected. 


boolean!|3sMonitoring () 
Returns the state of RtpMonitor. 


void] itemStateChanged(java.awt.event.ItemEvent ie) 
Take action when selection boxes are used. 


static void]main(java.lang.String[]} args) 
Method called upon executing class RtpMonitor. 
void| showFeedbacks () 
Updates the stream feedbacks. 
void| showGlobalStats () 
Updates the global statistics. 
void! showParticipants (} 
Updates the lists of active and passive participants. 


void} showStreamStats () 
Updates the stream statistics. 


awt.Frame 












Methods inherited from class java. 






addNotify, getCursorType, getFrames, geticonImage, getMenuBar, gevuStauce 
getTitle, isResizable, remove, removeNotify, setCursor, setIconImage, 
setMenuBar, setResizable, setState, setTitle 









Methods inherited from class java.awt.Window 


addWindowListener, applyResourceBundle, applyResourceBundle, dispose, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit, getWarningString, hide, isShowing, pack, postEvent, 
removeWindowListener, setCursor, show, toBack, toFront 





Methods inherited from class java.awt.Container 












add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentaAt, 
getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, 
getMinimumSize, getPreferredSize, insets, invalidate, isAncestoroOf, 
layout, List, list, locate, minimumSize, paint, paine@emponen =, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, setFont, setLayout, update, validate 
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Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addinputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFront, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, 
printAll, removeComponentListener, removeFocusListener, 
removelInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 


equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 


RtpMonitor 





public RtpMonitor() 
Constructor. It is called by main() if no command line argument is passed. 


The constructor initializes the GUI components. 


Method Detail 


actionPerformed 


public void actionPerformed(java.awt.event.ActionEvent e) 


Takes action when buttons are selected. 
Specified by: 
actionPerformed in interface java.awt.event.ActionListener 





He 


showGlobalStats 
public void showGlobalStats () 


Updates the global statistics. 





showParticipants 
public void showParticipants () 


Updates the lists of active and passive participants. 





showStreamStats 
public void showStreamStats () 


Updates the stream statistics. 


showFeedbacks 
public void showFeedbacks () 


Updates the stream feedbacks. 





itemStateChanged 
public void itemStateChanged(java.awt.event.ItemEvent ie) 
Take action when selection boxes are used. 


Specified by: 
itemStateChanged in interface java.awt.event.ItemListener 





isMonitoring 
public boolean isMonitoring() 
Returns the state of RtpMonitor. Also exits the program if the duration is over. 


Returns: 
true if the monitor is active 
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main 
publie stetic vVold main(javea-.lang.String|[) ards) 


Method called upon executing class RtpMonitor. If there is no argument an object of 
class RtpMonitor will be instantiated and executed, otherwise the same will happen 
with an RtpMonitorCommandLine object. 


Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
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org.web3d.vrtp.rtp 


Class RtpMonitorCommandLine 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.RtpMonitorCommandLine 





public class RtpMonitorCommandLine 
extends java.lang.Object 


A class used to start a RTP monitor from command line inputs. 
This monitor does not have the option of playing streams. 
Version: 

1.0 


Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


RtpMonitorCommandLine(java.lang.String[] args) 
Constructor. 


Method Summary 


static voidimain(java.lang.String[] args) 
Method called upon executing class RtpMonitorCommandLine. 


() 
Method that will create the RtpMonitorManager object and will exit the 
program when the user defined duration is elapsed. 





-|Constructor Detail 


RtpMonitorCommandLine 
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public RtpMonitorCommandLine(java.lang.String(] args) 


Constructor. It reads the command line arguments and sets variables and flags. The 
command line arguments have the following format: 


java RtpMonitorCommandLine rtpLocator [options] 

rtpLocator example: rtp://224.2.125.50:50328/127 

-part : monitor sends RTCP packets 

-play : monitor play streams 

-record : monitor records statistics 

-i nnn : nnn defines the recording interval in seconds (default 30s) 

-e ppp : ppp defines the monitoring duration in hours (default: 168 hs) 
-help : displays command line format and aborts 


Parameters: 
args - an array of strings 


Method Detail 


main 
public static: void main(java.lang.string| | args) 


Method called upon executing class RtpMonitorCommandLine. 


- Fun 


Ppuelier vole run} 


Method that will create the RtpMonitorManager object and will exit the program when 
the user defined duration is elapsed. 





Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
. SUMMARY: INNER j| FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
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org.web3d.vrtp.rtp 


Class RtpMonitorManager 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.RtpMonitorManager 





public class RtpMonitorManager 
extends java.lang.Object 
implements javax.media.rtp.ReceiveStreamL istener 


A class that encapsulates all operations necessary to start a new monitoring session, play its 
streams, and record statistical data. 


This class does not display statistics on screen. That must be done by another class, usually a 
frame, using data from a SessionManager object ( see method getSessionManager ). 


Version: 
1.0 
Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


RtpMonitorManager (java.lang.String locatorString, boolean willParticipate, 
boolean willPlayStreams, boolean willRecord, double recordInterval) 









Method Summary 


void! close () 
Closes a monitor session, stops recording and closes 
player windows 


RtpMediaLocator | gatMediaLocator () 
Returns the RtpMediaLocator associated with the RTP 


session 


javax.media.rtp.SessionAddress getSessionAddress() 
Returns the SessionAddress object associated with the 


RTP session 
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javax.media.rtp.SessionManager getSessionManager () 
Returns the SessionManager object created by the 
monitor 


update 
(javax.media.rtp.event.ReceiveStreamEvent event) 


Method of classes that implement the 
ReceiveStreamListener interface 


Methods inherited from class java.lang.Object 


equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 


Constructor Detail 


RtpMonitorManager 





public RtpMonitorManager (java.lang.String locatorString, 
boolean willParticipate, 
boolean willPlayStreams, 
boolean willRecord, 
double recordInterval) 
throws java.net.MalformedURLException, 
java.net.UnknownHostException, 
javax.media.rtp.SessionManagerException, 
java.io.IOException 


Parameters: 
locatorString - the session description string format, e.g. 
rtp://224.2.134.67:50980/127 


willParticipate - true if the Monitor will participate in the session, sending 
RTCP packets, false otherwise. 


willPlayStreams - true if the Monitor will play the receiving streams, false 
otherwise. 


willRecord - true if the Monitor will record statistical data about the session, 
false otherwise. 


recordInterval - the time between data recordings in seconds 

Throws: 
java.net.MalformedURLException - if the locatorString argument does not 
conform to the syntax. 


java.net. UnknownHostException - if InetAddress.getByName(session address) 
fails 


javax.media.rtp.SessionManagerException - Exception thrown when there is an 
error starting an RTPSessionManager 


java.io.IOException - Exception thrown when there is an error in 
RTPSessionManager 


Method Detail 


update 


public void update(javax.media.rtp.event.ReceiveStreamEvent event) 


Method of classes that implement the ReceiveStreamListener interface 
Specified by: 
update in interface javax.media.rtp.ReceiveStreamListener 





close 


public void close() 


Closes a monitor session, stops recording and closes player windows 





getMediaLocator 


public RtpMediaLocator getMediaLocator () 


Returns the RtpMediaLocator associated with the RTP session 
Returns: 
the session media locator 





getSessionManager 


public jJavax.media.rtp.SessionManager getSessionManager ( ) 


Returns the SessionManager object created by the monitor 
Returns: 
the SessionManager (RTPSessionMgr) 





getSessionAddress 
- public javax.media.rtp.SessionAddress getSessionAddress() 


Returns the SessionAddress object associated with the RTP session 


Returns: 
the SessionAddress 


126 





Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 





Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 





org.web3d.vrtp.rtp 


Class RtpPlayerWindow 


java.lang.Object 


| 
+—-java. awe. Componenc 


+--jJava.awt.Container 


| 
+--java.awt.Window 
| 
+--java.awt.Frame 
| 
+--com.sun.media.ui.PlayerWindow 


| 
+--org.web3d.vrtp.rtp.RtpPlayerWindow 


public class RtpPlayerWindow 
extends com.sun.media.ui.Player Window 


This class is used to create a window for playing an audio/video stream. It is a subclass of 
Player Window, that added the capacity of modifying the window name. Both classes were 
developed by SUN. RTPPlayerWindow came with JMF1.1 sample code and PlayerWindow is 
in the file JMF jar. 


See Also: 
Serialized Form 


Fields inherited from class java.awt.Frame 


CROSSHAIR CURSOR, DEFAULT CURSOR, E RESIZE CURSOR, HAND CURSOR, ICONIFIED, 
MOVE CURSOR, N_RESIZE CURSOR, NE RESIZE CURSOR, NORMAL, NW RESIZE CURSOR, 
S _RESIZE _CURSOR, SE _ RESIZE _CURSOR, SW RESIZE SCURSCR, TEAT _CURSOR, 

W _RESIZE _CURSOR, WAIT _CURSOR 


Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP ALIGNMENT 


Constructor Summary 


RtpPlayerWindow(javax.media.Player player, java.lang.String title) 
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Method Summary 


Methods inherited from class com.sun.media.uil.PlayerWindow 





addNotify, controllerUpdate, doResize, killThePlayer, zoomTo 


Methods inherited from class java.awt.Frame 


getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, 
isResizable, remove, removeNotify, setCursor, setIconImage, setMenuBar, 
setResizable, setState, setTitle 
















Methods inherited from class java.awt. Window 









addWindowListener, applyResourceBundle, applyResourceBundle, dispose, 
getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit, getWarningString, hide, isShowing, pack, postEvent, 

c~emoveWindowListener, setCursor, show, toBack, toFront 













Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentx, 
getAlignmentY, getComponent, getComponentAt, getComponentAt, 


getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, 
getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, 
layout, list; List, locate, \minimunisol ze;-paint,. paintComponents, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, setFont, setLayout, update, validate 





Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addInputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, preparelImage, 
printAll, removeComponentListener, removeFocusListener, 
removeInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 
removePropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
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setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 





equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 


RtpPlayerWindow 


public RtpPlayerWindow(javax.media.Player player, 
java.lang.String title) 


Method Detail 


Name 


public void Name(java.lang.String title) 





Class Tree Deprecated Index Help 
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org.web3d.vrtp.rtp 


Class RtpUtil 


java.lang.Object 


| 
+--org.web3d.vrtp.rtp.RtpUtil 


public class RtpUtil 
extends java.lang.Object 


A class with some RTP utilities (static methods) 
Version: 
1.0 


Author: 
Francisco Afonso (afonso@cs.nps.navy.mil) 


Constructor Summary 


RtpUtil () 


Method Summary 


static long|correctSSRC(long ssrc) 
Converts an number represented as a signed integer(32 bits) to 
a long integer (64 bits). 


Static java.lang.String |getUsername (javax.media.rtp.Participant part) 
Returns the participant username 


Static Java.lang.String|getUsernameOrCNAME (javax.media.rtp.Participant part) 
Returns the participant's username or his CNAME, if no 
username 1s known. 


Methods inherited from class java.lang.Object 





equals, cetClass, NashCode, Notify, notifyAll, GoString, wait, wait, walt 


Constructor Detail 


ea 


RtpUtil 


public RtpUcr. | | 


Method Detail 


getUsername 
public static java.lang.String getUsername (javax.media.rtp.Participant part) 


Returns the participant username 
Parameters: 

part - the Participant object 
Returns: 

a string with the participant's username 


getUsernameOrCNAME 


public static java.lang.String getUsernameOrCNAME (javax.media.rtp. Participant 


Returns the participant's username or his CNAME, if no username is known. 
Parameters: 

part - the Participant object 
Returns: 

a string with the participant's username or CNAME 





correctSSRC 


public static long correctSSRC(long ssrc)} 


Converts an number represented as a signed integer(32 bits) to a long integer (64 bits). 
JMF methods return the SSRC as an integer. As the SSRC is a 32 bits number, some 
are represented in JMF as negative integers. This convertion is necessary to present 
SSRCs as a positive integer. 
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org.web3d.vrtp.rtp 


Class SelectBookmark 


java.lang.Object 
| 


+--JjJava.awt.Component 


+--java.awt.Container 


+--jJava.awt.Window 


+--JjJava.awt.Dialog 


| 
+--org.web3d.vrtp.rtp.SelectBookmark 


public class SelectBookmark 
extends java.awt.Dialog 
implements java.awt.event.ItemListener 


A Dialog to select a session bookmark. It displays a list choice of session names. 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
See Also: 

Serialized Form 


Fields inherited from class java.awt.Component 


BOTTOM ALIGNMENT, CENTER_ALIGNMENT, LEFT ALIGNMENT, RIGHT ALIGNMENT, 
TOP ALIGNMENT 


Constructor Summary 


SelectBookmark (java.awt.Frame parent) 


ee 


Constructor. 


Method Summary 


Activated when a bookmark choice is made. 





itemStateChanged(java.awt.event.ItemEvent e) 


Methods inherited from class Java.awt.Dialog 


‘ 


addNotify, dispose, getTitle, hide, isModal, isResizable, setModal, 
setResizable, setTitle, show 


Methods inherited from class java.awt.Window 


addWindowListener, applyResourceBundle, applyResourceBundle, 
getFocusOwner, getiInputContext, getLocale, getOwnedWindows, getOwner, 
getToolkit, getWarningString, isShowing, pack, postEvent, 

removeWindowListener, setCursor, toBack, toFront 






















Methods inherited from class java.awt.Container 


add, add, add, add, add, addContainerListener, countComponents, 
deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentxX, 
getAlignmentY, getComponent, getComponentAt, getComponentAt, 
getComponentCount, getComponents, getinsets, getLayout, getMaximumSize, 


getMinimumSize, getPreferredSize, insets, invalidate, isAncestoroOf, 
layout, listyiist, Tecate, Sinamumsize, Dainese, PDatnteCcComponents, 
preferredSize, print, printComponents, remove, remove, removeAll, 
removeContainerListener, removeNotify, setFont, setLayout, update, 
validate. 





Methods inherited from class java.awt.Component 


action, add, addComponentListener, addFocusListener, 
addinputMethodListener, addKeyListener, addMouseListener, 
addMouseMotionListener, addPropertyChangeListener, 
addPropertyChangeListener, bounds, checkImage, checkImage, contains, 
contains, createImage, createImage, disable, dispatchEvent, enable, 
enable, enableInputMethods, getBackground, getBounds, getBounds, 
getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, 
getFontMetrics, getForeground, getGraphics, getHeight, 
getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, 
getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, 
getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, 
isDisplayable, isDoubleBuffered, isEnabled, 1sFocusTraversable, 
isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, 
list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, 
mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, 
printAll, remove, removeComponentListener, removeFocusListener, 
removeInputMethodListener, removeKeyListener, removeMouseListener, 
removeMouseMotionListener, removePropertyChangeListener, 

remove PropertyChangeListener, repaint, repaint, repaint, repaint, 
requestFocus, reshape, resize, resize, setBackground, setBounds, 
setBounds, setComponentOrientation, setDropTarget, setEnabled, 
setForeground, setLocale, setLocation, setLocation, setName, setSize, 
setSize, setVisible, show, size, toString, transferFocus 


Methods inherited from class java.lang.Object 

































equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 


Constructor Detail 





SelectBookmark 
public SelectBookmark (java.awt.Frame parent) 
Constructor. 


Parameters: 
parent - the parent frame 


Method Detail 


itemStateChanged 
public void itemStateChanged(java.awt.event.ItemEvent e) 


Activated when a bookmark choice is made. 


Specified by: 

itemStateChanged in interface java.awt.event.JtemListener 
Parameters: 

parent - the parent frame 
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APPENDIX D. RTPMONITOR SOURCE CODE 


Package org.web3sda.vrip.ntp; 


ImMpOre Java.awl.*7 
import java.awt.event.*; 
imports java Uris; 


+ 


~ 
t ££ £ ££ €£ € HF ¥F 


™~ 


A Dialog to display information about the program 
e.g. version, date 
<P 


@author Francisco Afonso (afonso@cs.nps.navy.mil) 
@version 1.0 


public class About extends Dialog { 


fx 
=e OnseGuclOn. 
see Se 
* @param parent the parent frame 
af 
public About (Frame parent) { 
Super (ipanzent;-"About, » true); 
Setsize( 2/04, °200 > 
setLayout (null); 
setBackground(Color.lightGray) ; 


addWindowListener( new CloseWindow() ); 


Label versionLabel = new Label( "rtpMonitor version 1.0"); 
vyersionLabel.setBounds( 20,30, 150,< 25.3; 
add(versionLabel) ; 


Label versionDateLabel = new Label( "Version date: 30 August 1999"); 
versionDateLabel.setBounds( 20, 60, 180, 25 ); 
add(versionDateLabel); 


Label npsLabel = new Label( "Naval Postgraduate School"); 
npsLabel.setBounds( 20, 90, 150, 25 ); 
add(npsLabel) ; 


Label vrtpLabel = new Label( "virtual reality transfer protocol (vrtp)"); 
vVetpLabel .setBounds( 20,120, °200,..25-.); 
add(vrtpLabel) ; 


Label siteLabel = new Label( "http://www.web3d.org/WorkingGroups/vrtp/"); 
SiteLabel.setBounds( 20, 150, 240, 25 ); 
add(siteLabel); 

} 


¥/ end of class About 


Sy 


package org.web3d.vrtp.rtp; 


import 
Import 
import 
import 


The 
<P> 


+ £ ££ £ € £ 


/ 


jJava.awt.*; 
jJava.awt.event.*; 
JaVaw Miele” 7 
Java.1o- -- 


Dialog to add a session bookmark. 


@author Francisco Afonso (afonso@cs.nps.navy.mil) 
@version 1.0 


public class AddBookmark extends Dialog 


implements ActionListener { 


Vector sessionAddressVec, sessionNamesVec; 

Label sessionAddLabel, sessionAddRealLabel, sessionNameLabel; 
TextField sessionNameText; 

Button addButton, cancelButton; 

RtpMonitor theParent; 


[** 


PeCOnStEMUCEOR. 
ste c Al og 
* @param parent the parent frame 


A 


public AddBookmark(Frame parent) { 


Super( parent, "Add Bookmark" , true ); 
SEESi12E( 3505, 1/70"); 

setLayout (null); 
setBackground(Color.lightGray) ; 


addWindowListener( new CloseWindow() ); 


theParent = (RtpMonitor) parent; 
loadBookmarks(); 
sessionAddLabel = new Label( "Session Address:"); 


sessionAddLabel.setBounds( 10, 40, 100, 25 ); 
add (sessionAddLabel); 


sessionAddRealLabel = new Label( theParent.sessionText.getText()); 
sessionAddRealLabel.setBounds(115,40, 230, 25 ); 
add (sessionAddRealLabel) ; 


sessionNameLabel = new Label( "Session Name"); 
sessionNameLabel.setBounds( 10, 80, 100, 25 ); 
add(sessionNameLabel); 


sessionNameText = new TextField(theParent.sessionNameText.getText ()); 


sessionNameText.setBounds(110, 80, 230, 25); 
add (sessionNameText); 
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addButton = new Button("Add") ; 
ag@abutton.setBounds (100,130, 60,25) ; 
addButton.addActionListener (this); 
add (addButton) ; 


cancelButton = new Button("Cancel"); 
Cance | Button-.set bounds (2700; 130,60, 25); 
cancelButton.addActionListener (this); 
add (cancelButton) ; 


/** 
* Takes action when buttons are selected. 
* 
oa, 
public void actionPerformed( ActionEvent e ) 
{ 
if( e.getSource() == addButton) { 
String sessAdd = theParent.sessionText.getText().trim(); 
String sessName = sessionNameText.getText().trim(); 
if( !sessName.equals("") ){ 


sessionNamesVec.addElement (sessName) ; 
sessionAddressVec.addElement (sessAdd) ; 
saveBookmarks(); 
theParent.sessionNameText.setText( sessName ); 
setVisible(false); 


1f( e.getSource() == cancelButton) { 
setVisible(false) ; 


[** 
* Loads the session bookmarks from file "bookmarks.txt" 
77 

private void loadBookmarks() { 


sessionAddressVec = new Vector(); 
sessionNamesVec = new Vector(); 


Eryt 
BufferedReader input = new BufferedReader( new 
FileReader ("bookmarks.txt") ); 
String line; 
while( (line = input.readLine()) != null) { 
int pos = line.lastIndexOf("rtp://"); 
if (pos != -1){ 
sessionAddressVec.addElement( line.substring(pos).trim() ); 
sessionNamesVec.addElement( line.substring{ 0 , pos ).trim() ); 
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} 
Primi. Close ():; 
} 
catch ( FileNotFoundException e) { 
System.out.println( "Add Bookmarks: " + e.getMessage() ); 


} 
eacceh ( LTOException ©€){ 


System.err.printlin( "Exception reading bookmark: "™ + e.getMessage() ); 
} 
} 
[*~* 
* Saves the session bookmarks to file "bookmarks.txt" 
my, 
private void saveBookmarks() { 
PrintStream Output; 
iva 
output = new PrintStream(new FileOutputStream("bookmarks.txt", false) ); 


for(int ii1=0; 11 < sessionAddressVec.size(); ++1i1) { 
output.print( (String) sessionNamesVec.elementAt (ii)); 


CUED print ( “ae 


output.printlin( (String) sessionAddressVec.elementAt(ii) ); 


} 


OUEDUL -elose ()7 


} 
catch (FileNotFoundException e) { 
System.out.println( "Saving bookmarks : " + e.getMessage() ); 


} 
Catch { POEXception e) { 
System.err.printlin( “Exception writing bookmark: " + e.getMessage() ); 


} 


} 


} // end of class AddBookmark 
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package org.web3d.vrtp.rtp; 


import java.awt.event.*; 


[** 

* This class is used to set a frame/dialog as not visible 
* when the close icon is clicked. 

* @author Francisco Afonso (afonso€cs.nps.navy.mil) 

* @version 1.0 

oy 


public class CloseWindow extends WindowAdapter { 


ties 
* set frame/dialog as not visible. This method is activated when the window 


* ais closed. 
* 


xf 
public void windowClosing( WindowEvent e ) 


{ 
e.getWindow().setVisible( false ); 


} 


} // end of class CloseWindow 


14] 


package org.web3d.vrtp.rtp; 


import java.awt.*; 
import java.awt.event.*; 
TMS Cise waiava Util. ~: 
IMpOrES ava. 16. *; 


[*~* 
* A Dialog to delete a session bookmark. 
- Sap > 
* 
* @author Francisco Afonso (afonso@cs.nps.navy.mil) 
Pave tsaon 1.0 
a 
public class DeleteBookmark extends Dialog 
implements ActionListener { 


java.awt.List sessionNamesList; 
Vector sessionAddressVec; 
Button deleteButton, cancelButton; 


es 
heCONSEERUCHOm. 
<P 
* @param parent the parent frame 
x7 
public DeleteBookmark(Frame parent) { 
super( parent, "Delete Bookmark" , true ); 
Seto1ze( 250 , 300). 
setLayout (null); 
setBackground(Color.lightGray) ; 


addWindowListener( new CloseWindow() ); 


sessionNamesList = new java.awt.List( 5 , false); 
sessionNamesList.setBounds (10,30,230,210); 


loadBookmarks(); 
add(sessionNamesList) ; 


deleteButton = new Button("Delete"); 
deleteButton.setBounds (50,260, 60,25); 
deleteButton.addActionListener (this); 
add (deleteButton) ; 


cancelButton = new Button("Cancel"); 
cancelButton.setBounds (130,260,60,25); 
cancelButton.addActionListener (this); 
add (cancelButton); 
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jer 
* Takes action when buttons are selected. 
* 


i 
public void actionPerformed( ActionEvent e ) 
{ 
if( e.getSource() == deleteButton) { 
int index = sessionNamesList.getSelectedIndex(); 


ii windexso= fOr jd 
sessionNamesList.remove (index) ; 
sessionAddressVec. remove (index) ; 
saveBookmarks (); 


} 


if( e.getSource() == cancelButton) { 
setVisible(false); 
} 


/** 
* Loads the session bookmarks from file "bookmarks.txt" 
aed 

private void loadBookmarks () { 


sessionAddressVec = new Vector(); 


ery | 
BufferedReader input = new BufferedReader( new 
FileReader("bookmarks.txt") ); 
SEering Jane: 
while( (line = input.readLine()) != null) { 
Int pos = line.lastindexOr ("rtp: 7/7") > 
if (pos != -1){ 
sessionAddressVec.addElement( line.substring(pos).trim() ); 
sessionNamesList.add( line.substring( 0, pos ).trim() ); 
} 
} 
Inputsclose()-; 
} 
catch ( FileNotFoundException e) { 
System.out.println( "Delete Bookmarks: " + e.getMessage() ); 
} 
catch ( IOException e) { 
System.err.printin( "Exception reading bookmark: " + e.getMessage() 


} 
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ers 


Vie 
* Saves the session bookmarks to file "bookmarks.txt" 
ef 
private void saveBookmarks() { 
PeintStream OULDUL-; 


try { 


output = new PrintStream(new FileOutputStream("bookmarks.txt", false) ); 


for(int ii=0; ii < sessionAddressVec.size(); ++ii) { 
output.print( sessionNamesList.getItem(ii)); 


OUEDUEC DE nt saan. 


output.printin( (String) sessionAddressVec.elementAt(ii) ); 


} 


SuLpUuG,. close); 


} 
catch (FileNotFoundException e) { 
System.out.printin( "Saving bookmarks : " + e.getMessage() ); 


} 
catch ( IOException e) { 
System.err.printin( "Exception writing bookmark: " + e.getMessage() ); 


} 


} 


} // end of class DeleteBookmark 
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package org.web3d.vrtp.rtp; 


import javax.media.rtp.*; 
import javax.media.rtp.event.*; 
import. Javax.media.rtp.rtcp.*; 


import jJava.awt.*; 
import java.util. *; 


{** 

* A class used by RtpMonitor objects to periodically launch their showStats 
* methods (screen updates). 

Pi 

* 

* @author Francisco Afonso (afonso@cs.nps.navy.mil) 

* @version 1.0 

sa 


public class DisplayTask implements Runnable { 


RtpMonitor myMon; 
SessionManager mymgr; 
Thread thread; 

int intervalParam; 


[** 
* -CONStEUCtOr. (It creates a“newrthread ot execution rand scalis 
Scie meenod,7un(). 
* 
* @param mon the RtpMonitor object that will be called back for screen 
* updates. 
* @param interval the interval between screen data updates, in seconds. 
Bere 


public DisplayTask(RtpMonitor mon, double interval) { 


myMon = mon; 
intervalParam = (int) (interval*1000); 


thread = new Thread(this, "DisplayTask thread") ; 


thread. setDaemon (true); 
thread.start(); 
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| Pal 
* This method runs continuously calling the showStats methods of RtpMonitor 
* in the proper presentation interval, until the RtpMonitor stops the 
* session. 
a 
publvevolderun ge 

while (myMon.isMonitoring()) { 


myMon.showGlobalStats(); 
myMon.showParticipants(); 
myMon.showStreamStats(); 
myMon.showFeedbacks(); 


ery, 


Thread.sleep(intervalParam) ; 


} 


catch (InterruptedException e) {} 


} 


} // end of class DisplayTask 


146 


package org.web3d.vrtp.rtp; 


IMPOLt savas. 100"; 
iipest javasuEll, ; 


[** 

* A class used by RecordTask objects to organize statistics 

* in several files ( five minutes, hour, and day ). 

* <F? 

* This class writes to the file following files: 

* statisticsLastFiveMinutes.txt, statisticsPreviousFiveMinutes.txt, 
* statisticsLastHour.txt, statisticsPreviousFiveMinutes.txt, and 
* StCatisticsbDateMM-DDP-YYYY.CxXt- 

* 

* @author Francisco Afonso (afonso€cs.nps.navy.mil) 

=eeversion 1.0 

* 


™~ 


public class FileCatalog{ 


Calendar rightNow; 

String prefix; 

String dateRef; 

int minuteRange, hourRange; 

boolean flgFirstDataMin; 

File mins, minolast, hour, -nourlast; header: 


Constructor. It checks if there are previous data from the same session 

ane transiters these data to the Corrmect StatisticsveremM-DD Yr12-cxt file, 
Then it clears all "five minutes" and "hour" data files. 

<P> 

Gparam pret ta string ‘containing the directory where thesdaca muse be written 
7 

public FileCatalog( String pref) { 


t+ ££ + £ £ HF 


prefix = pref; 


// creates File objects 
min5 = new File( prefix + "LastFiveMinutes.txt"); 


min5last = new File( prefix + "PreviousFiveMinutes.txt"); 
hour = new File( prefix + "LastHour.txt"); 
hourlast = new File( prefix +"PreviousHour.txt"); 


header = new File( prefix + "Header.txt"); 


J// vetrieves the date ct last record for this session 
String lastDateRef = retrieveDateRef(); 


// copies the header file to the session directory if it does not exit 
if( ! header.exists() ){ 
concatenate( prefix + "Header.txt" , "Header.txt" ); 


} 
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Tiloeiino.exLsts.( jt 


// if there is a last five minutes file, transfers its contents! to vere 
// last hour file and deletes the last £iverminutes file 
if( lastDateRef != null ){ 
concatenate (prefix + "LastHour.txt" , prefix + "LastFiveMinutes.txt" ); 
} 
minS.delete(); 


} 


// deletes the previous five minutes file if it exists 
if( minSlast.6éxises( joe 
minSlast.delete(); 


} 
2f( Hour exists 


// if there is a last Nour, transfers its contents to the 
// related date file file and deletes the last hour file 


if( lastDateRef != null ){ 
String dateFileName = new String(prefix +"Date" + lastDateRef+". txt"); 
concatenate( dateFileName , prefix + "LastHour.txt" ); 


} 
hour.delete(); 


} 


// deletes the previous hour file if it exists 
DP (shourlast -exases (it 

hourlast.delete(); 
} 


flgFirstDataMin = true; 


[** 
* Method that will update the files, transfering data from 
* statisticsLastReport: Exe, toutne —seerorrlatenaiies- 
* 
* @param time the current time as a Calendar object. 
aig 
public void update( Calendar time) { 


rightNow = time; 


// displays the current time on the console 
System.out.println( sightNow.qetlime()-tostring (ey. 

// minuteRangeNow represents a block of five minutes 

int minuteRangeNow = rightNow.get(Calendar.MINUTE) / 5; 


int hourRangeNow = rightNow.get (Calendar.HOUR OF DAY) ; 

String dateNow = new String( (rightNow.get(Calendar.MONTH) + 1) + "-" + 
rightNow.get (Calendar.DAY OF MONTH)+ "="=4 
rightNow.get (Calendar.YEAR) ); 
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// if it is the first report of the session 
if(flgFirstDataMin) { 

minuteRange = minuteRangeNow; 

hourRange = hourRangeNow; 

dateRef = dateNow; 

saveDateRef (dateRef); 

flgFirstDataMin = false; 
} 


if( minuteRangeNow != minuteRange ) { 
// if it is new block of five minutes 


// appends data from the five minutes file to the last hour file 
concatenate( prefix + "LastHour.txt" , prefix + "LastFiveMinutes.txt") ; 
if( mindlast.exists()){ 

mindlast.delete(); 
} 


// rename last five minutes file to previous five minutes file 
mindS.renameTo(mindlast); 
minuteRange = minuteRangeNow; 


1f( hourRangeNow != hourRange ) { 
// if it is a new hour 


// appends data from the last hour to the related date file 
String dateFileName = new String(prefix + "Date" + dateRef + ".txt" ); 
concatenate( dateFileName , prefix + "LastHour.txt" ); 
af ( nourlast.exists() ){ 
hourlast.delete(); 
} 


// renames the last hour file as the previous hour file 
hour.renameTo(hourlast); 
hourRange = hourRangeNow; 


// if it iS a new date save the actual date in the 
// statisticsLastDateRef file 
if( ! dateRef.equals( dateNow ) ) { 

dateRef = dateNow; 

saveDateRef (dateRef) ; 


} 
// 1f there is not a new five minutes block just append the last report 


// to the existing last five minutes file 
concatenate( prefix + "LastFiveMinutes.txt", prefix + "LastReport.txt" ); 
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% 


Utility to concatenate two files. 


@param filel the first file ( filel <- filelM+ file2 ). If £illel does hes 
exits thes method wili@ece, fileZ to file 

<P> 

@param file2 the file to be appended to filel. 


$ + £ £ F F € 


— 


public static void concatenare( String filel ectring tile? |) 4 


try 
FileOutputStream output = new FileOutputStream( filel, true ); 
FileInputStream input = new FileInputStream( file2 ); 
int mybyte; 
while( (mybyte = input.read()) '= -1 ){ 
output.write(mybyte) ; 
} 


Output. close); 
input.close(); 


} 
catch( FileNotFoundException e) { 
System.out.printin("File not found " + e.getMessage()); 
} 
catch( IOException e ){ 
System.out.printlin("IOException : " + e.getMessage()); 


} 


ae 
* This method saves in a file a date in a string format. It is 
* used for save the date of the last report. 
* The file name is statisticsLastDateRef.txt. 
* 
* @param dater a string representing a date as DD-MM-YYYY 
* / E 
public void saveDateRef( String dater ){ 


cry | 
DataOutputStream output = new DataOutputStream( 
new FileOutputStream( prefix + "LastDateRef.txt") ); 


output.writeUTF( dater ); 
output.close(); 


} 
catch( FileNotFoundException e) { 
System.out.println("File not found " + e.getMessage()); 


} 
catch( IOException e ){ 


System.out.printlin("IOException : " + e.getMessage()); 
} 
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/** 
* This method retrives a date in a string format from the file 
* StacisticslastbDateRnect. Ext. 


* 
* @return string representing a date as DD-MM-YYYY 
she 

public String retrieveDateRef () { 


String result — null; 


try { 
DataInputStream input = new DataInputStream ( 
new FileInputStream( prefix + "LastDateRef.txt") ); 


result = input.readUTF(); 
Paces cLose().; 


} 
catch( FileNotFoundException e) {} 


catch( IOException e ){ 
System.out.println("IOException : ™" + e.getMessage()); 


} 


return result; 


} // end of class FileCatalog 


package org.web3d.vrtp.rtp; 


import java.awt.*; 
import jdvawawe. even. -, 
import jiavanteu.. 


[*~* 

* AR Dialog to display and modify the program preferences. 
2 

* 

* @author Francisco Afonso (afonso@cs.nps.navy.mil) 

* @versione 0 

a 


public class ModifyPreferences extends Dialog { 


protected Checkbox recordBox, partBox, playBox; 
protected Label intervalLabel, intervalPresLabel, endLabel, viewerLabel; 
protected TextField intervalText, intervalPresText, viewerText; 
protected Choice endChoice; 
private String [|] strendsin = { "1 hour", “2 hours. a. 4) nomecn: 

"8 hours", “lz hours", “24 hours", “2 days Ge) week 


[** 
“Constructor. 
* <P> 
* @param parent the parent frame 
= 
public ModifyPreferences(Frame parent) { 
Super( parent, "Preferences" , true ); 
S€tsSize()Zo0, zou"), 
setLayout (null); 
setBackground (Color.lightGray) ; 


addWindowListener( new CloseWindow() ); 


partBox = new Checkbox("Send RTCP packets", true); 
part Box=setSounds (107507 1405 25), 
partBox.setBackground(Color.lightGray) ; 

add (partBox) ; 


playBox = new Checkbox("Play incoming media", true); 
playBox.setBounds (10, 60,160, 25) ; 
add (playBox) ; 


recordBox = new Checkbox("Record statistics", true); 
recordBox.setBounds (10, 90,140,25); 
add (recordBox) ; 


intervalLabel = new Label( "Record Interval(sec)"); 
intervalLabel.setBounds( 10, 120, 120, 25 ); 
add(intervalLabel); 

intervalText = new TextField("30.0"); 
intervalText.setBounds (130,120, 40,25); 


add(intervalText); 


intervalPresLabel = new Label( "Presentation Interval (sec)"); 


a 


Ineerva Presuabel.setBounds( 10, 150, 140, 25 3; 
add(intervalPresLabel); 


intervalPresText = new TextField("5"); 
intervalPresText.setBounds (160,150, 40,25); 
add(intervalPresText) ; 


endLabel = new Label( "Monitoring Period") ; 
endlabel. serBounds( 10, 180, 100, 25 ); 
add(endLabel); 


endChoice = new Choice(); 

endG@no1 ce; set Bounds (1205. 180, 46074 25); 

add(endChoice) ; 

FOrMCLNE cli =O elie < StrEnCSs ne engtii; = +4i1.)4 
endChoice.add (strEndsin/ii]); 

} 


endChoice.select (0); 


viewerLabel = new Label( "External viewer:"); 
viewerLabel.setBounds( 10, 210, 120, 25 ); 
add (viewerLabel); 


viewerText = new TextField("c:/Program Files/accessories/wordpad.exe") ; 
viewerText.setBounds (20, 240, 230,20); 

viewerText.setFont( new Font( null , Font.PLAIN , 10 ) ); 

add (viewerText) ; 


loadPreferences(); 
} 
/** 
* Enables the GUI input elements 
iat A 


public void enableInput () { 
recordBox.setEnabled(true) ; 
Part sox, setenabled (trie); 
playBox.setEnabled(true) ; 
intervalText.setEnabled(true); 
intervalPresText.setEnabled(true); 
endChoice.setEnabled(true); 
viewerText.setEnabled(true) ; 


} 


/** 

* Disables the GUI input elements 

a 6 

public void disableInput() { 

recordBox.setEnabled(false); 
partBox.setEnabled (false) ; 
playBox.setEnabled (false) ; 
intervalText.setEnabled(false) ; 
intervalPresText.setEnabled(false); 
endChoice.setEnabled(false); 
viewerText.setEnabled(false) ; 


| sas 


* Saves the preferences in the file preferences.txt 


we 


public void savePreferences() { 


ery 


OuEDUTE 
Output 
outpUuL 
CuteUuT 
OUEDUE 


SUuEPUE. 
.writeUTF(viewerText.getText()); 


CuUEDUE 


SUL DUL. 


} 


DataOutputstream output = new DataOutputStrean ( 


new FileOutputStream("preferences.txt") 


.writeBoolean( partBox.getState()); 
.writeBoolean( playBox.getState()); 
.writeBoolean( recordBox.getState()); 


.writeUTF(intervalText.getText()); 
.writeUTF(intervalPresText.getText()); 


( 
writeInt (endChoice.getSelectedIndex()); 
( 


close(); 


catch( FileNotFoundException e) { 
System.out.printin("File not found " + e.getMessage()); 


} 


catch( IOException e ) { 
System.out.printin("IOException : " + e.getMessage()); 


} 
} 


/** 


* Loads the preferences from the file preferences.txt 


yee 


private void loadPreferences() { 


heya 


DataInputStream input = new DataInputStream ( 


new FileInputStream( "preferences.txt") 


partBox.setStatetinput.readBoolean()); 
playBox.setState(input.readBoolean()); 
recordBox.setState(input.readBoolean()); 
intervalText.setText (input.readUTF()); 
intervalPresText.setText (input.readUTF()); 
endChoice.select(input.readiInt()); 
viewerText.setText (input.readUTF()); 


INPUEee Lose |, 


} 


catch( FileNotFoundException e) {} 


catenl TOExzcepticnee ) x 
System.out.printin ("IOException : " + e.gqetMessage@)),; 


} 
} 


} // end of class ModifyPreferences 


154 


Pe 


Me 


Package org. webJd vrtp.rtp; 


import javax.media.rtp.*; 
Import Javax media rep. event .~; 
import javax.media.rtp.rtcp.*; 


IMPOCrt Java.10..7 >; 
IMPOrL. jJava.sal.*; 
import jJaves,urcLlLy*; 


/** 

* AR class used by RtpMonitorManager objects to write the statistics 

* periodically to disk. It is created as a separate thread that waits for 
a fixed period of time after writing data to disk. 

<2 


contains only the last single report. The FileCatalog class is actually 
responsible for transferring the data to the file 
"statisticsLastFiveMinutes.txt" and other files. 


@author Francisco Afonso (afonso@cs.nps.navy.mil) 
@version 1.0 
j 


public class RecordTask implements Runnable { 


+ + £ £ £ £ F F FF F 


SessionManager mgr; 
RtpMonitorManager myMon; 
Thread thread; 
boolean flgRun; 
PrintStream output; 
Stringsdis; 

String prefix; 
String filename; 
Calendar timeNow; 
FileCatalog cat; 
int recordParam; 


/*~* 

* Constructor. It creates the session directory where the stats files will be 
* written. Also it creates a FileCatalog object that will organize the data in 
* several files (five minutes, hour and day). 

* 

* 

* @param mon the RtpMonitorManager that manages the monitoring session. 

* 


<P> 


This class writes data to the file called "StatisticsLastReport.txt", that 


* @param recInterval the interval between statistic samples, in seconds. 


ay 

public RecordTask(RtpMonitorManager mon, double recInterval) { 
// saves parameters as internal variables 
myMon = mon; 


recordParam = (int) (recInterval * 1000); 


// gets the session manager associated with the monitoring session 
mgr = myMon.getSessionManager(); 
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// gets session address and port 
String session = myMon.getMediaLocator().getSessionAddress(); 
String spore. — 
(new Integer (myMon.getMediaLocator().getSessionPort ())).toString(); 


// creates a new subdirectory for saving session statistics 

dir = new String( "./session” + session.replace('.','-') + "port" +pommue 
File newdir = new File(dir); 

newdir.mkdir(); 


// creates file statisticsLastReport.txt 
prefix = new String( dir + “/statictics' |), 
filename = new String ( prefix + "LastReport.txt"™ ); 


// creates a FileCatalog object 
cat = new FileCatalog( prefix ); 


// executes as a thread 

thread = new Thread(this, "Record thread"); 
thread.setDaemon (true); 

thread.start (); 


/** 
* Resets a flag that is checked each time the thread associated with this 


* object is awaken after the wait command, causing the thread to end. 
* 


if 

public void exit () { 
flgRun = false; 

g 


[** 
* Starts executing the recording and waiting until the recording interval 


* is over, in a J¢o0p,-untll the “exit” method ts calted. 
* 


a 
publisc@vetd sun (| 


flgRun = true; 


// runs continuously until stopped 
while (flgRun) { 


Em 4 


// opens the last report file 
output = new PrintStream( new FileOutputStream( filename, false) ); 


// gets actual time 
timeNow = Calendar.getInstance(); 


// records statistics on file 


recordGlobalStats(); 
recordStreamStats(); 
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| hale! 


* Records global statistics 


* 


a 


} 


catch 
SYStemsoute -oraint in ( 


} 


recordFeedbacks(); 


// calls the FileCatalog object to manage the data between the 


lJ Several, fa les 
cat.update (timeNow) ; 


finally { 
GUEDUE «CLOSE ()3 


} 


try{ 
Thread.sleep (recordParam) ; 


} 


Catch 


(FileNotFoundException e) { 
"In RecordTask 


(InterruptedException e) {} 


private void recordGlobalStats(){ 


GlobalReceptionStats stats = 


OuUL DU. 
output 


Output 
OUT DUE 
Output 


eo 


OucCpuUe. 


output 
OuEDUL 
OuEDUL 
OUEDUE 
Out DUT 
OutDUL 
OuULPUE 
Oucout 
Outpue 
GUcDUt 
output 


" + e.getMessage() 


( lines starting with D1 ) 


mgr.getGlobalReceptionStats(); 


Drinu Die 
-print( (new Time(timeNow.getTime().getTime()).toString() 
Orne es ye; 
eprint (mor.gqeth | Participants ().size()) 7 
pr imcare. \ 
print (mgr.getRemoteParticipants().size() ); 
Pio) ais ae Gxearaae 
»print(mgr.getActiveParticipants().size() ); 
POR cater oer 
.print(stats.getBytesRecd() ); 
oe os ae i a eM rs 
-print(stats.getPacketsRecd() ); 
~prEanets yy 
.print (stats.getRTCPRecd() ); 
Ms hee 5) oh oy Chena er 

( 


-print (stats 


Ar op al aN oe Ga 


OucDUCL. 
OUTDUC < 
COUCDUC. 


Ouctpue 


ZDELNEAS 


Oucoue. 
OuCpDUL. 
SUEDUE. 


OU COUL 
oOutpUuL 


ape he 


VW 
print (stats 
print” "); 
print(stats 
"); 
print (stats 
Drinere 4); 
print(stats 
ee 


»print (stats 


»GetSkRecd({) )- 
.getBadRTPkts() ); 
.getBadRTCPPkts() ); 
.getMalformedSR() ); 
.getMalformedRR() ); 


.getMalformedSDES () 


ay) 


os 


Le 


Ve 


} 
[** 


* Records stream statistics 


* 


ees 


OUEB LE. 


output 
OUT Die 
OUEDUE 
output 


OUuEBUE 
fe) bh al sb 2 


CutBuE 


( 
ap Gint (Ss 
- Diente 
mouine (Ss 
Hjchask hag ay 
CUEDUE. (s 
eutcpuT (et 
OUEDUE. (s 
{pein 
(Paine (Stas. 
CutpurEe 


ete ee 


‘e 


ie 
Prine cs 
jan aKone 
Pranc 


oe, 
a 


Prine (ee), 


stats.getMalformedBye () 
EQctSe 
tats. 


tats. 


gethocalcollis()); 
getRemoteColls() ); 
get PacketsLooped () 
getTransmitFailed() 


-printlin(stats.getUnknownTypes () 


( lines starting 


private void recordStreamStats() { 


ReceiveStream stream; 
ReceptionStats stats; 


Pari rverpantipare,; 
Long SSK, 
Strang CNAME; 


Vector aux = 
for(int 1 ne 
stream = 
part 
Soke 

if (part 
CNAME = 


} 


mgr.getReceiveStreams (); 
i] Aux 2SiZe(): 
(ReceiveStream) 


++ii) { 


aux.elementAt (1 


= stream.getParticipant (); 
= RtpUutil -cesrectSsRre( stream getSsRe())); 


else { 


CNAME = 


} 


Stacce 


OUTDUE 
SurtpuEsz 
GuUTDUE 
output 
OutpUEc 
output 
GUE DUE 
output 
OUEDIIES 
COULD. 
OULU 
output 
OuUEDUT 
CUuLDUL 


Babar hene 
Din & 


Besant she 


, Disa t 
-Drinte 
;PELTIE 
Sorin ec 
Prange 


fpeine.t? 


A epenk) seal (a 


!= null) { 
stream.getParticipant () 


( 

( 

( 
IOPSe IME Steele 

(a? , 

(sta 

(# ' 

(stats. 
Prine (Stats. 


.print (stats. 


-GeteDUlose() ja; 


getPDUMisOrd() ); 


getPDUInvalid() 
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7 


A 
) ° 
) ° 


getPDUProcessed() 


td 


hs 


td 


? 


Ve 


.printlin(stats.getPDUDuplicate() 


with BZ 


aL) A 


. GetCNAME () ; 


new String("Unknown Participant") ; 


stream.getSourceReceptionStats(); 


1s 


) 


Vr 
* Records feedback statistics ( lines starting with D3 ) 
* 
id 

private void recordFeedbacks() { 


Participant part; 

Vector reports, feedbacks; 
Report rep; 

Feedback feedbk; 

Strang “CNAME; 

long fromSskC, aboursskc; 
double £race ron; 

long packetsLost, jitter; 


Vector aux mgr.getAllParticipants(); 
fOr lintel —20; Yli< aus. size () ot) 4 
part = (Participant) aux.elementAt (ii); 
CNAME = part.getCNAME (); 
reports = part.getReports(); 
FOr (int) 1-0; ja «eee Pperes. Size att ty 4 
rep = (Report) reports.elementAt (jj); 
fromSSRC = Repvutil: correct SSRCt rep sgetSSReci) }; 
feedbacks = rep.getFeedbackReports(); 
for( int kk=0; kk < feedbacks.size(); ++kk) { 


feedbk = (Feedback) feedbacks.elementAt (kk); 
aboutSSRC = RtpUtil.correctSSRC( feedbk.getSSRC() ); 
fraction = (feedbk.getFractionLost ())/256.0; 


packetsLost = feedbk.getNumLost (); 
jitter = feedbk.getJitter(); 


"D3 ip ; 
CNAME ); 


fo) Dim ob hamy pastas 
CUEDUL, prince 
GUcDUL «Prine, i); 
SUCDUL print LYONSSRe 4); 
OuveUE. Prine’ 5 
QUEDUE sprint (-abouessRe-); 
CUutLpUe pring(’ ~~); 
CucpUTapriae (fraction 1c 
( 
( 


ee gee gm gt 


OUL DUE prumt (20 235 
GULDUC.Print( packetsiosc )- 
OUTSUEdprint(* “34 
CUEDUE<printin( jiteer ic 


return: 


} // end of class RecordTask 


159 


package org.web3d.vrtp.rtp; 


import javax.media.*; 
import Javax.media.rtp. =; 
import java.lang.*; 
import javerwers: ; 


» 


/ 
A class that represents necessary information to define 
an RTP session, as address, port and TTL. 


<P> 
@author Francisco Afonso (afonso@cs.nps.navy.mil) 
@version 1.0 


ApS RP Oh RP Re LP kr 


SS 


public class RtpMediaLocator extends MediaLocator{ 


/** 

* Defines the value of TTL if not provided. 
x 

public static final int TTL_UNDEFINED = 1; 


Private semiue address = "Ty 


PrlVate 1neepore, 
PEivate int ttl — TTL UNEPESaED, 


[*~* 
“ GConserucren. 
@param locatorString Describes the session. It should have the 
following format: 
rtp:7 /address:port (|/ttl] , where. 


, 


* <P> 

2 address -> multicast address of the rtp session 
+ <p> 

se port -> port number 

* <p> 

~ ttl (Opeteonal) =>" eime-co-live 

“rs 


public RtpMediaLocator (String locatorString) throws MalformedURLException 
{ 


Supem( ~bOcarorceriand) > 


PalrSseLocator( LocatorSt ring); 


} 
// this method parses the locator string to get the various session data 
// as address, port and ttl 
private void parseLocator(String locatorString) 
throws MalformedURLException { 


String remainder = getRemainder(); 


int colonIndex = remainder.indexOf(":"); 
int slashIndex = remainder.indexOf("/",2); 
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// gets the address 


Pm cotonindex: |= = 1) 
address = remainder.substring(2, colonIndex) ; 
else { 


throw new MalformedURLException ( 
MRT PR @Mecialocatlor iS ,invalld.» Must (be Of form cep: / /adds -port/tti"): 


} 


// tests if the address is valid 
ery; 
InetAddress Iaddr = InetAddress.getByName (address) ; 
} 
catch (UnknownHostException e){throw new MalformedURLException ( 
"Valid RTP Session Address must be given"); 


} 


// gets the port 
SEEMNOspOLesEer = 
if (slashIndex == -1) 
portstr = remainder.substring(colonIndex +1, 
remainder.length()); 


vere. 
, 


else 
portstr = remainder.substring(colonIndex +1, 
slashIndex) ; 


// tests if the port is an integer 
tryi 
Integer Iport = Integer.valueOf (portstr) ; 
port = Iport.intValue(); 
}catch (NumberFormatException e) { 
throw new MalformedURLException ( 
"RTP MediaLocator Port must be a valid integer"); 


} 


//AGets tne tel 
if (slashIndex != -1){ 


String ttlstr = remainder.substring(slashIndex+l, 
remainder.length()); 
try{ 
Integer Ittl = Integer.valueOf(ttlstr); 
ttl = Ittl.intValue(); 
}catch (NumberFormatException e) {} 


/** Returns the RTP Session address 
*@return String form of the RTPSession address 
aed 
public String getSessionAddress() { 
return address; 


} 
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[= 
* Retwrns, the RIP sessienmoert. 
* @return RTP session port 
<7 
DUD Lemme cet SeSSLONPOre On 
Feeurn port; 


} 


[** 


* Returns the session Time-to-lLlive. 


* @return time-to-live (TTL) 
ie 
public Ime Germaine 
FetUrniete lL; 


} 


// end of class RtpMediaLocator 
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package org.web3d.vrtp.rtp; 


import javax.media.rtp.*; 
import javax.media.rtp.event.*; 
LMDOrL Javax.Medla-Lrtp.rtep.”*; 


import java.awt.*; 
import java.awt.event.*; 
import java.net.*; 
ImeOrk Javan. * ; 

Imeeonrt java,util.*; 


ess 
“sine RtpMonitor Application. 
* <P> 
* This class is a frame that implements the RtpMonitor GUI. <P> 
* If any command line argument is passed the RtpMonitorCommandLine class 
* is called instead. 
* 

* @author Francisco Afonso (afonso@cs.nps.navy.mil) 
* @version 1.0 
* 


ie 


public class RtpMonitor extends Frame 
implements ActionListener, ItemListener { 


TextField sessionText, sessionNameText; 

TextArea activeArea, passiveArea, feedbkArea; 

Choice streamChoice; 

Button start, stop, changeStream; 

Label sessionLabel, sessionNameLabel, streamLabel, feedbkLabel; 

Label endLabel; 

Label globalStatLabel, activeLabel, passiveLabel, feedbkFieldsLabel; 

Label [] gLab; 

fexctrielda.(]-oText; 

Strang [|] ‘oField = {"Total Bytes", “Total Packets”; "RICP Packets’, 
"SR Packets", "Bad RTP Packets", “Bad RTCP Packets", 
"Bad SR Packets","Bad RR Packets", “Bad SDES Packets", 
"Bad BYE Packets", "Local Collisions", 
"Remote Collisions", "Looped Packets", 
"Failed Transmission", "Unknown Type™ }; 

Label [] rbab; 

TextField [] rilext; 

String [] rField = {"Lost PDUs", "Processed PDUs", "MisOrdered PDUs", 
"Invalid PDUs”, *"Duplicate PDUs" |; 


imtiu[ | -endsinhHowrs = 1, 2,4, 8, 12; 24, 46,; 262 3) 
String locator; 

boolean flgqPart, tlogPlay, tlqRecord; 
boolean flgActive = false; 

int presinterval; 

double recInterval; 
RtpMonitorManager monMgr; 
SessionManager mymgr; 

DisplayTask dispTask; 

long SSRCtoshow; 

Hashtable streamTable; 

boolean flgUpdateStreams; 


Date endDate; 

MenuBar bar; 

Menu preferences, bookmarkMenu, filesMenu, helpMenu; 

MenuItem viewPref, modifyPref, selectBm, addBm, deleteBm, aboutItem; 

MenuItem last5Item, previousSItem, lastHourItem, previousHourItem, headerItem; 
MenuItem exitItem; 

ModifyPreferences modPrefDialog; 


SelectBookmark selBmDialog; 

DeleteBookmark delBmDialog; 

AddBookmark addBmDialog; 

About aboutDialog; 
[** 


* Constructor. It is called by main() if no command line argument is passed. 
<< > 
* The constructor initializes the GUI components. 
ua 
public RipMomiuon © 
{ 
Super (7 RtpMenicor: )7, 
setSize(780,530); 
Set lavoui eau lles) 


preferences = new Menu("Preferences"); 


viewPref = new MenulItem("View"); 
viewPref.addActionListener (this); 
modifyPref = new MenulItem("Modify"); 
modifyPref.addActionListener (this); 


preferences.add( viewPref ); 
preferences.addSeparator(); 
preferences.add( modifyPref ); 


bookmarkMenu = new Menu("Bookmarks"); 


addBm = new MenulItem("Add") ; 
addBm.setEnabled(false); 

deleteBm = new MenulItem("Delete") ; 
selectBm = new MenulItem("Select"); 
selectBm.addActionListener(this); 
deleteBm.addActionListener (this); 
addBm.addActionListener (this) ; 


bookmarkMenu.add( selectBm ); 
bookmarkMenu.addSeparator(); 
bookmarkMenu.add( addBm }); 
bookmarkMenu.addSeparator(); 
bookmarkMenu.add( deleteBm ); 


filesMenu = new Menu("File"); 


last5Item new MenulItem("Last five minutes"); 
last5Item.addActionListener (this); 

previousSItem = new MenulItem("Previous five minutes"); 
previousSItem.addActionListener (this); 
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lastHourItem = new MenulItem("Last hour"); 
lastHourItem.addActionListener (this) ; 
previousHourItem = new MenulItem("Previous hour"); 
previousHourItem.addActionListener (this) ; 
headerItem = new Menultem("Header") ; 
headerItem.addActionListener (this) ; 

exitItem = new MenulItem("Exit"); 
exitItem.addActionListener (this); 


filesMenu.add( last5SItem ); 
filesMenu.add( previous5SItem ); 
filesMenu.add( lastHourlItem ); 
filesMenu.add( previousHourItem ); 
filesMenu.addSeparator(); 
filesMenu.add( headerItem ); 
filesMenu.addSeparator(); 
filesMenu.add( exitItem ); 


helpMenu = new Menu("Help") ; 


aboutItem = new MenulItem("About"); 
aboutItem.addActionListener (this); 
helpMenu.add( aboutItem) ; 


bar = new MenuBar(); 
bar.add(filesMenu) ; 
bar.add(bookmarkMenu) ; 
bar.add(preferences) ; 
bar.add(helpMenu) ; 


setMenubar( (bar 2% 
modPrefDialog = new ModifyPreferences (this) ; 


sessionLabel = new Label( "Session Address"); 
sessionLabel.setBounds( 10, 60, 100, 25 ); 
add(sessionLabel); 


sessionText = new TextField("rtp:// : : ; : / ae Be 


Session ltext asset sounce (110 60, .<230, .256)5 
add(sessiontText) ; 


sessionNameLabel = new Label( "Session Name"); 
sessionNameLabel.setBounds( 360, 60, 90, 25 ); 
add(sessionNameLabel) ; 


sessionNameText = new TextField(""); 
sessionNameText.setBounds (450, 60, 180, 25 ); 
add(sessionNameText) ; 


Start = new Button("Start"); 

Start .«Se€EBOuUNnadSs (6605 “60, 407s 251)? 
start.addActionListener( this ); 
start.setEnabled(true); 

adad{start)-; 
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stop = new Button("Stop"); 

Step .seebounds( /20, 6074025.) 
stop.addActionListener( this ); 
stop.setEnabled(false); 

add(stop); 


globalStatLabel = new Label( "Global Statistics"); 
globalStatbabel.setBounds{ 160, 100, lOO} ager 
add (globalStatLabel); 


gLab = new Label[15]; 
gText = new TextField[15]; 
int offsetx = 0; 
int offsety = 0; 
fOr ( int 1i—0-> ac 5S aa 
if (i1==8) { 
Offset x=—220- 
OLESe@y——(11~25), 
} 
gLab[ii] = new Label( gField[ii] ); 
gGLab[11].setBounds( 10toffsetz, 130+ (ti*25)4+6ffsety, Its pezone 
add( gLab[ii]); 
gText[ii] = new TextField( "" ); 
gText [11] .setBounds( 125+offsetx, 130+ (11*25)+offsety, 90, 20m 
gText [ii] .setEditable (false); 
aqd (qlext [aa] 


} 


activeLabel = new Label( "Active Participants") ; 
activeLabel.setBounds( 50, 340, 140, 20 ); 
add(activeLabel) ; 


activeArea = new TextArea( “", 0, 0, TextArea.SCROLLBARS BOTH ); 
activeArea.setBounds (10,360, 175, 180); 

activeArea.setFont( new Font( "Courier" , Font.PLAIN , 12 ) ); 
activeArea.setEditable(false); 

add(activeArea); 


passiveLabel = new Label( "Passive Participants"); 
passiveLabel.setBounds( 230, 340, 140, 20 ); 
add (passiveLabel) ; 


passiveArea = new TextArea( "", 0, 0, TextArea.SCROLLBARS BOTH ); 
passiveArea.setBounds (195, 360, 175, 180); 
passiveArea.setFont( new Font( "Courier" , Font.PLAIN , 12 ) ); 


passiveArea.setEditable(false) ; 
add (passiveArea) ; 


streamLabel = new Label( "Stream") ; 
streamLabel.setBounds( 470, 120, 50, 25 ); 
add (streamLabel); 


StreamChoice = new Choice(); 
streamChoice.setBounds (520, 120, 250, 25); 
streamChoice.setEnabled(false); 
streamChoice.addItemListener (this); 
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add(streamChoice); 


changeStream = new Button("Change") ; 
changeStream.setBounds( 720, 150, 50, 25 ); 
changeStream.addActionListener( this ); 
changeStream.setEnabled(false); 

add (changeStream) ; 


rLab = new Label [5]; 

rText = new TextField[5]; 

EO (hit bee — Oe Ge 5 ea Pe) 
rLab(ii] = new Label( rField[ii] ); 
Yhablidt)w2serebounds (45007) J70+(117 25), 200; 20 ); 
add( rLab[ii]); 
rText[ii}] = new TextField( "" ); 
rlext|(411) -setbounds (3605, 6/0 (125) 90, 8 20); 
rText[ii].setEditable(false) ; 
add( rText[ii]}); 


} 


feedbkLabel = new Label( "Feedback Reports"); 
feedbkLabel.setBounds( 510, 315, 100, 20 ); 
add(feedbkLabel); 


feedbkFieldsLabel = new Label ( 

"Username Fraction Lost JIELECY Packets Lost"); 
feedbkFieldsLabel.setBounds( 420, 340, 350, 20 ); 
add (feedbkFieldsLabel) ; 


feedbkArea = new TextArea( "", 0, 0, TextArea.SCROLLBARS VERTICAL ONLY ); 
feedbkArea.setBounds (410,360, 360, 180); 

feedbkArea.setFont( new Font( "Courier”™ , Font.PLAIN , 12 ) ); 
feedbkArea.setEditable(false); 

add (feedbkArea); 


setVisible (true); 

streamTable = new Hashtable(); 

this.addWindowListener (new WindowAdapter () { 
public void windowClosing(WindowEvent e) { 


System.exit (0); 


ee 
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/** 
* Takes action when buttons are selected. 
* 
*/ 
public void actionPerformed( ActionEvent e ) 
{ 
1f( e.getSource() == start) { 
start.setEnabled(false) ; 
disableInputs(); 
locator = sessionText.getText (); 
recinterval = Double.parseDouble ( 
modPrefDialog.intervalText.getText()); 


presinterval = Integer.parselInt ( 
modPrefDialog.intervalPresText.getText()); 
flgPart = modPrefDialog.partBox.getState(); 


flgPlay = modPrefDialog.playBox.getState(); 
flgRecord = modPrefDialog.recordBox.getState(); 
SSRCtoShow = QO; 
endDate = new Date( (new Date()).getTime() 
+ endsinHours [modPrefDialog.endChoice.getSelectediIndex()]*3600000L) ; 


if( startSession() ){ 
stop.setEnabled(true); 
addBm.setEnabled (true) ; 
changeStream.setEnabled (true); 
flgUpdateStreams = true; 

} 

else{ 
start.setEnabled(true) ; 
enableiInputs(); 


} 


1f( e.getSource() == stop) { 
flgActive = false; 
stop.setEnabled(false) ; 
addBm.setEnabled(false); 
monMgr.close(); 
monMgr = null; 
mymgr = null; 
clearAllData(); 
changeStream.setEnabled(false) ; 
start.setEnabled(true) ; 
enableInputs(); 

} 


if( e.getSource() == changeStream) { 
changeStream.setEnabled(false)j; 
flgUpdateStreams = false; 
clearStreamData(); 
streamChoice.setEnabled(true) ; 
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if( e.getSource() == modifyPref) { 
modPrefDialog.setTitle("Modify Preferences") ; 
modPrefDialog.enableInput () ; 
modPrefDialog.setVisible (true); 
modPrefDialog.savePreferences (); 


if( e.getSource() == viewPref) { 
modPrefDialog.setTitle("View Preferences"); 
modPrefDialog.disableInput(); 
modPrefDialog.setVisible (true) ; 


if( e.getSource()== selectBm) { 
selBmDialog = new SelectBookmark(this); 
selBmDialog.setVisible (true) ; 
selBmDialog = null; 


if( e.getSource()== deleteBm) { 
delBmDialog = new DeleteBookmark (this); 
delBmDialog.setVisible (true) ; 
delBmDialog = null; 


1f( e.getSource()== addBm) { 
addBmDialog = new AddBookmark (this) ; 
addBmDialog.setVisible (true) ; 
addBmDialog = null; 


if( e.getSource()== last5SItem) { 
runViewer( sessionText.getText() , "“LastFiveMinutes.txt"); 


if( e.getSource()== previous5Item) { 

runViewer( sessionText.getText() , "PreviousFiveMinutes.txt") ; 
} 
if( e.getSource()== lastHourItem) { 


runViewer( sessionText.getText() , "LastHour.txt"); 


1f( e.getSource()== previousHourlItem) { 
runViewer( sessionText.getText() , "PreviousHour.txt"); 


if( e.getSource()== headerItem) { 
runViewer( sessionText.getText() , "Header.txt") ; 


1f( e.getSource()== aboutItem) { 
aboutDialog = new About (this); 
aboutDialog.setVisible (true); 
aboutDialog = null; 
} 
if( e.getSource()== exitItem) { 
SYVstemsexit (0); 
} 
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[** 
* starts the monitoring session by creating a RtpMonitorManager object. 
a 


private booleanystart Sesomen a) { 


// tries to create the RtpMonitorManager object 
EE 
monMgr = new RtpMonitorManager(locator, flgPart, flgPlay, 
flgRecord, recInterval); 
mymgr = monMgr.getSessionManager(); 
} 
catch( MalformedURLException e ) { 
feedbkArea.setText ( 
"MalformedURLException creating RtpMonitorManager:" + '\n'); 
feedbkArea.append( e.getMessage() ); 
return false; 
} 
catch (UnknownHostException e ){ 
feedbkArea.setText ( 
"UnknownHostException creating RtpMonitorManager:" + '\n'); 
feedbkArea.append( e.getMessage() ); 
return false; 
} 
catch( SessionManagerException e ) { 
feedbkArea.setText ( 
"SessionManagerException creating RtpMonitorManager:" + '\n'); 
feedbkArea.append( e.getMessage() ); 
return false; 
} 
Catch ( 1TOException m= ec.) 
feedbkArea.setText( "IOException creating RtpMonitorManager:" + '\n"'); 
feedbkArea.append( e.getMessage() ); 
return false; 


} 
flgActive = true; 


// creates a DisplayTask object to update the statistics on screen 
dispTask = new DisplayTask( this, presInterval ); 


return true; 


} 


[** 

* Updates the global starmstires. 
wy 

public void showGlobalStats() { 


GlobalReceptionStats stats = mymgr.getGlobalReceptionStats(); 


gText [0].setText( new Integer(stats.getBytesRecd()).toString() ); 
gText[l].setText( new Integer(stats.getPacketsRecd()).toString() ); 
gText[2].setText( new Integer(stats.getRTCPRecd()).toString() ); 
gText[3].setText( new Integer (stats.getSRRecd()).toString() ); 
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} 
[** 


eiext (4].setText.( new Integer(stats.getBadRTPkts{)) .toStrimg() ); 
gText[(5].setText( new Integer(stats.getBadRTCPPkts()).toString() 
gText[6].setText( new Integer(stats.getMalformedSR()).toString() 
gText[7].setText( new Integer(stats.getMalformedRR()).toString() 
gText[8].setText( new Integer(stats.getMalformedSDES()).toString ( 
gText [9] .setText( new Integer(stats.getMalformedBye()).toString() 
gText[(10].setText( new Integer(stats.getLocalColls()).toString() 


gText[{1l].setText( new Integer(stats.getRemoteColls()).toString() 
gText[{12].setText( new Integer (stats.getPacketsLooped()).toString 
gText[13].setText( new Integer(stats.getTransmitFailed()).toStrin 
gText(14].setText( new Integer(stats.getUnknownTypes()).toString ( 


* Updates the lists of active and passive participants. 


ol 


public void showParticipants(){ 


aes 


activeArea.setText(""); 
Vector aux = mymgr.getActiveParticipants(); 


Participant part; 
Fortine wt = Ori aus%.S17e (a) 
part = (Participant) aux.elementAt (11); 
activeArea.append( RtpUtil.getUsernameOrCNAME (part) + '\n'); 
passiveArea.setText(""); 
aux = mymgr.getPassiveParticipants(); 


for (ine t= OF .31< aus asa ze() 3s Si) 
part = (Participant) aux.elementAt (11); 


( 
g 
) 


passiveArea.append( RtpUtil.getUsernameOrCNAME (part) + '\n'); 


* Updates the stream statistics. 


ar 


public void showStreamStats () { 


if( !flgUpdateStreams) { 
return; 


} 


ReceiveStream dispStream = null; 
ReceiveStream stream; 
ReceptionStats stats; 
Participant part; 

SEring display; 

streamChoice. removeAll (); 
StreamTable.clear(); 


Vector aux = mymgr.getReceiveStreams(); 
FOr (int. 2is=s0 5" 11 au sk 59 Ze) set 


jeri 


) 
) ° 
) 
) 


e 
tA 
v 


e 
¢ 


Io; 
yee 


) 
) 
( 
) 


f 


tf 


) 


e 
¢ 


; 


stream = (ReceiveStream) 


part 


= stream.getParticipant (); 


if(part != null 
display = new String( RtpUtil.getUsernameOrCNAME (part) + " 
RtpUtil.correctSSRC (stream.getSSRC() ) 


} 


else{ 


){ 


aux.elementAt (ii); 


display = new String( "unknown participant / " + 
RtpUtil.correctSSRC (stream. getSSRC() ) 


} 


streamChoice.add(display) ; 


streamTable.put( display, 


new Long( stream.getSSRC() ) ); 


if( stream.getSSRC() == SSRCtoShow ) { 
dispStream = 
streamChoice.select (ii); 


stream; 


if( SSRCtoShow == Q) { 
if( aux.size() > O){ 
(ReceiveStream) aux.elementAt (0); 


dispStream = 
SSRCtoShow = dispStream.getSSRC() ; 
} 
} 
if( dispStream == null) { 


for (imi )=—0; 


aio 


pee gj al) a 


rTeéxtiaei..setiexn: 7). 


} 


SSRCtoShow = QO; 
reeurcn: 


} 
stats = 


rilexserG 
rhext 1} 
rrext |Z 
rText [3] 
rText [4] 


dispStream.getSourceReceptionStats (); 


.setText ( 
.setText ( 
.setText ( 
.setText ( 
~setText ( 


new 
new 
new 
new 
new 


Integer(stats 
Integer(stats 
Integer(stats 


INnESGSE (Stats. 
Integer(stats. 


52 


-GeePBUlOst () 2 eostring (aon 
.getPDUProcessed()) .toString ( 
-get PDUMrsOrd() )=tosering( 


getPDUInvalid()).toString() 
get PDUDuplicate()).toString ( 


/ 


) 


); 
) 


he 


6 


Vi 


 s 


+ 


{/*~* 

x Updates the stream feedbacks. 
a 

public void showFeedbacks () { 


if( !flgUpdateStreams) { 
LeEuEn; 


} 


Participant part; 

Vector reports, feedbacks; 
Report rep; 

Feedback feedbk; 


feedbkArea.setText(""); 

Vector aux = mymgr.getAllParticipants(); 

for(int ii = 0; ii< aux.size(); ++i1i1){ 
part = (Participant) aux.elementAt (ii); 


PeEPOLlLSy— Part.gernerports(); 


for( int 43j3=0; j33< reports.size(); ++33) { 
rep = (Report) reports.elementAt (jj); 
feedbacks = rep.getFeedbackReports(); 
for( int kk=0; kk < feedbacks.size(); ++kk) { 
feedbk = (Feedback) feedbacks.elementAt (kk) ; 
if( feedbk.getSSRC() == SSRCtoShow ) { 
feedbkArea.append( fil1lBlanks ( 
RtpUtil.getUsernameOrCNAME (part) , 19 ) + 


tT LA ) : 


double fraction = (feedbk.getFractionLost ())/256.0; 
feedbkArea. append ( 
fi Pie lankst scouring. vValucOt (fraction), 6) 0+" a oe 


feedbkArea. append ( 
fillBlanks (String. valueOf (feedbk.getJitter()),8) + 


feedbkArea. append ( 
fillBlanks( String.valueOf (feedbk.getNumLost()),10) 


es El ee 
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[** 
* Take action when selection boxes are used. 
wt 
public void itemStateChanged( ItemEvent ie ) 
{ 


if( ie.getSource() == streamChoice) { 
SSRCtoShow = ((Long) streamTable.get( ie.getItem() ) ).longValue(); 


flgUpdateStreams = true; 
changeStream. setEnabled (true); 
streamChoice.setEnabled(false) ; 


Toes 

* Clears all stats info on screen. 
otf 

private void clearAllData() { 


for (int 39-0, sto tet 
gText [jj].setText(""); 

} 

for(int 397=0; J7-o a aoa 
rText(jj].setText(""); 

} 

activeArea.setText(""); 

passiveArea.setText(""); 

feedbkArea.setText(""); 


streamChoice.removeAll (); 
streamTable.clear(); 


} 
[** 


* Clears all stream related stats. 
Saf, 
private void clearStreamData() { 
for(int 3j=0; 349<5; ++535) { 
rrext lj 7 eserlexu Cw. 
} 
feedbkArea.setText(""); 
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[** 
* Disable user input components( used after a session is started ) 
ad 
private void disableInputs() { 
sessionText.setEnabled(false); 
modifyPref.setEnabled(false) ; 
selectBm.setEnabled(false); 


} 


/** 
* Enable user input components( used after a session is stoped ) 
a 
private void enableInputs() { 
sessionText.setEnabled (true) ; 
modifyPref.setEnabled(true); 
selectBm.setEnabled(true); 


[** 
* Returns the state of RtpMonitor. Also exits the program if the duration 
*E iS. Over. 
* @return true if the monitor is active 
ual 
public boolean isMonitoring() { 
if( endDate.compareTo(new Date()) < 0 ){ 
System.exit (0) ; 
} 


return flgActive; 


Dol 

* Creates a string with a fixed size, starting by a given string and ending 
* with blank spaces. 

* @param strin the original string 

* @param size the final size of the returning string 

Areluarn a String 

* 


/ 


brivete String £1iliBlanks( String strin, int size) 


{ 


StringBuffer spaces = new StringBuffer (); 
for(int. ia. = OF 24 <=isizer 2411-7) 4 
spaces.append( " "); 


} 


String newString = new String( strin + spaces ); 


return newString.substring( 0, size); 


Wes) 


/** 

* Runs an external program specified in the preference menu 
+ EO Grspilay OUEDUE fa lose 

* @param locator the session RtpMediaLocator 

* @param fileName the name of the file to be displayed 

st 


private void runViewer(String locator, String fileName) { 
String prehace, 
Runtime r = Runtime.getRuntime() ; 


tEyt 
RtpMediaLocator rtpml = new RtpMediaLocator (locator); 
String session = rtpml.getSessionAddress (); 


String port = (new Integer(rtpml.getSessionPort())).toString(); 
String Gir = new Strange .7/sesoicon 
1 SCSS1lON. replace ()..'; "=" ) "port. spe eore | 


PECEIx == New String ("dar + V/statistics, a). 
} 
catch (MalformedURLException e) { 
System.out.printlin( e.getMessage() ); 


reLrurn, 
} 
Cea 
String prog = new String( modPrefDialog.viewerText.getText() +" " + 
prefix + fileName ); 
Process p = r.exec(prog) ; 


} 
catch ( TOBxception? e) { 
System.err.println( e.getMessage() ); 


[** 
* Method called upon executing class RtpMonitor. If there is no 
* argument an object of class RtpMonitor will be instantiated 
* and executed, otherwise the same will happen with an 
* RtpMonitorCommandLine object. 
yy 
public static veid main(@etring@)) args ) 
{ 
int nArgs = args.length; 


if(args.length == 0) { 
RtpMonitor myProg = new RtpMonitor(); 
} 
else{ 
RtpMonitorCommandLine myProg = new RtpMonitorCommandLine( args ); 
MYELOG.run 
} 
} 


} // end of class RtpMonitor 
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package org.web3d.vrtp.rtp; 
import javax.media.rtp.*; 
import 
import jJavax.media.rtp.rtcp.*; 
Java.20. 7; 

jJavainet.*; 

java uel. *; 


ImMoert 
import 
import 


+ 


/ 


<P> 
This monitor does not have 


@author 
@version 1.0 


+ £ £ + F € F 


ee 


javax.media.rtp.event.*; 


A class used to start a RTP monitor from command line inputs. 


the option of playing streams. 


Francisco Afonso (afonso@cs.nps.navy.mil) 


public class RtpMonitorCommandLine { 


boolean willpart = false; 
boolean willplay = false; 


boolean willrecord = false; 
Sirang stoecacor = null; 
double interval = 30.0; 

int endsInHours = 168; 

Date endDate; 
RtpMonitorManager monMogr; 

7 ek 


* Method called upon executing class RtpMonitorCommandLine. 


os 


PUblLIC static vold‘mainist 


RtpMonitorCommandLine myProg = 


myProg:run(); 


t 


Constructor. 
variables and flags. 
The command line argume 
<P> 


rtpLocator example: 
=part monitor sends 
-play monitor play 
-record monitor rec 
=I - nn mnn defines 
== Dpp ppp defines 
hs) <P> 
-help 


te OB Oe OR Oe Fe ee 


java RtpMonitorCommandLine rtpLocator [options] 


ring [] args) { 


new RtpMonitorCommandLine( args 


It reads the command line arguments and sets 


nts have the following format: 


<P> 

PED (22042 3125.50. 00SZes12T aes 
RIVCPubpackets- <F> 

streams <P> 

ords statistics <P> 

the recording interval in seconds 
the monitoring duration in hours 


displays command line format and aborts 
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je 


(default 30s) 
(default: 


Les 


<P> 


* <P> 
* @param args an array of strings 


ae 


public RtpMonitorCommandLine (String [] args) { 


int nArgs = args.length; 
if( nArgs == 0) { 
SVs rccneouc. Princ ln ( 
"Format: java RtpMonitorCommandLine rtpLocator <options>") ; 
System. out, print In( 
". rtpLocator examplemertp: //224 720254502 50325712) > 
System.out -prant ln 
=) Opr1ons:) —paLle monitor sends RTCP packets" ); 
SVS Gen). Culp maim: lat 
-play monitor play streams"); 
System, Out-printin( 
se =record 3) monlbor records estattsrnes ') 5 
Svstem, OUE=print im 
a -i nnn : nnn defines the recording interval in seconds 


} 


System. 


" 


System. 


System. 


(default 30s)"); 


Cit. primed n | 
-e ppp ppp defines the monitoring duration in hours 
(default: P6eens ) "re: 
QUE. prince nd 
-help displays command line format and aborts "); 
exe ON 7 : 
if( args(0]-indexOr("-nelp” ) == 0 ) { 


} 


System. 
"Format: 
System. 


@ybne -jopeake je dljeul| 
java RtpMonitorCommandLine rtpLocator <options>"); 
ese onaatione db gl 


" xtplocator example: ctp://224.2.125. see 503237427 wae 


SYStem.«Gue.princin ( 
™) Options: =part : monitor sends RIGE@seckets WG; 
System.out.println ( 
, -play : monitor play streams"); 
System. Out. printin‘’ 
. -record monitor records statistics"); 
System. out.printin ( 
A -i mnn : nnn defines the recording interval in seconds 
(default 30s)"); 
SVStem. OWE prinelat 
. -e ppp : ppp defines the monitoring duration in hours 
(default: 168 hs)"); 
Syvsten. out. prancin( 
" ~help displays command line format and aborts "); 
System.exit (0); 


// parses 
locator = 
a bp gy igpege ge ge cl 

while( ii < nArgs ){ 

if( args[ii].indexOf("-part") == 0) { 


willpart = 


the command line arguments to extract the options 
args [0]; 


true; 
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} 

else if( args[ii].indexOf("-play") == 0) { 
willplay = true; 

} 

else if( args[ii] .indexOf("-record") ==0 ) { 
willrecord = true; 


} 


else if( (args[1ii].indexOf("-i") == 0) && (ii < nArgs -1) ) { 
interval = Double.parseDouble(args[ii+l]); 
} 
else if( (args[{ii].indexOf("-e") == 0) && (ii < nArgs -1) ) { 
endsInHours = Integer.parselInt (args{ii+l]); 
} 
Lit+; 
} 
endDate = new Date( (new Date()).getTime() + endsInHours*3600000L) ; 


// displays the selected options on the console 


Ssystem.out.printin(locator = " + locator ); 
SyYStemzout. printin(playe= " + willplay-); 
System.out.printlin("part = " + willpart ); 
SYStem. Ouccprimein( record <= | +iwilivrecord: ):; 
System.out .-printin("recording interval = " + anterval + " seconds." ); 
System.out.println("monitoring duration = " + endsInHours + " hours." ); 
} 
[** 


* Method that will create the RtpMonitorManager object and will exit the 
* program when the user defined duration is elapsed. 

+7 

Public yold<run(){ 


// tries to create the RtpMonitorManager object 
try { 
monMgr = new RtpMonitorManager(locator, willpart, willplay, 
willrecord, interval); 


} 


catch( MalformedURLException e ){ 
System.err.printin ( 
"MalformedRTPMRLException creating RTPMonitorManager: ” ); 
System.err.println( e.getMessage() ); 
System.exit (0); 
} 
catch (UnknownHostException e ) { 
System.err.printin ( 
"UnknownHostException creating RTPMonitorManager: " ); 
System.err.println( e.getMessage() ); 
System.exit (0); 
} 
catch( SessionManagerException e ){ 
System.err.printin ( 
"RTPSessionManagerException creating RTPMonitorManager: " ); 
System.err.println( e.getMessage() ); 
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Svstem exit (0); 


} 

Seacch( LOEXCeption “cane 
System.err.printin("TOBxception creating RIPMonitorManager:| >); 
System.err.printlin( e.getMessage() ); 
System.exit (0); 

} 


// runs until the user aborts the program (ctrl-C) or the 
// monitoring period is over 
while (true) { 


// tests if the monitoring period is over 

if( endDate.compareTo(new Date()) < 0 ){ 
System.exit(0); 

} 


Gry 


Thread.sleep (50000) ; 


} 
catch (InterruptedException e) {} 


} 


} // end of class RtpMonitorCommandLine 
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package org.web3d-vrtp.xrtp; 


import javax.media.rtp.*; 
import javax.media.rtp.event.*; 
IMpert javax.media.rtp.rtcp.*; 


// RTPSessionMgr class 

imMpert COm.sun.media.rtp.*; 
impert java.1o.*; 

MnpOLrk java.net. *; 

Imoort java. Util. ; 

import javax.media.*; 

import javax.media.protocol.*; 


[** 

* A class that encapsulates all operations necessary to start a new 

* monitoring session, play its streams, and record statistical data. 
ie 

* This class does not display statistics on screen. That must be done 
* by another class, usually a frame, using data from a SessionManager 
* object ( see method getSessionManager ). 

* 

* @author Francisco Afonso (afonso@cs.nps.navy.mil) 

* @version 1.0 

* 


<< 


public class RtpMonitorManager implements ReceiveStreamListener { 


private RtpMediaLocator rtpml = null; 
private SessionManager mgr = null; 
private SessionAddress sessaddr = null; 
private boolean flgPart; 

private boolean flgPlay; 

private boolean flgRecord; 

private Hashtable windowlist; 

private RecordTask recTask; 


s 


/ 
@param locatorString the session description string 
formatweeeGg srt!) 1224-2. Loaner SUseUy ie, 
<P> 
@param willParticipate 
true if the Monitor will participate in the session, 
sending RTCP packets, false otherwise. 
<P> 
@param willPlayStreams true if the Monitor will play the 
receiving streams, false otherwise. 
<P> 
@param willRecord true if the Monitor will record statistical 
data about the session, false otherwise. 
<P> 
@param recordInterval the time between data recordings in seconds 
@exception MalformedURLException 


<P> 
@exception UnknownHostException 
if InetAddress.getByName(session address) fails 


+ + + £ FF ££ F + + £F + F F F € + F KF FF 


<P> 
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if the locatorString argument does not conform to the syntax. 


* @exception SessionManagerException 


z Exception thrown when there is an error starting an 

ss RTPSessionManager 

* <P> 

* @exception IOException 

2 Exception thrown when there is an error in RTPSessionManager 
lls 


public RtpMonitorManager( String locatorString, boolean willParticipate, 
boolean willPlayStreams, boolean willRecord , 
double recordiInterval) 
throws MalformedURLException, UnknownHostException, 
SessionManagerException, IOException 


flgPart = willParticipate; 
flgPlay = willPlayStreams; 
flgRecord = willRecord; 


// creates the RtpMediaLocator object 
rtpml = new RtpMediaLocator (locatorString) ; 


// creates an empty RtpSessionManager object 
mgr = new RTPSessionMgr (); 


// if the user select to play the streams, registers as a 
// listener for received streams 
1ftrlerlayvig 

mgr.addReceiveStreamListener (this) ; 

windowlist = new Hashtable(); 


} 


// gets the InetAddress of the session 
InetAddress destaddr = InetAddress.getByName (rtpml.getSessionAddress()); 


// gets the session port 
int port = Gepml.geesesslonbore (|; 


// creates a SessionAddress objet to represent the session 
sessaddr = new SessionAddress ( destaddr, port, destaddr, port+l ); 


// call the method to generate a CNAME for the user 
String cname = mgr.generateCNAME (); 


// gets the username from the system and adds it to 
// the string "/rtpMonitor". That will be the user name sent in 
// RTCP packets 
String username = null; 
ceva 
username = System.getProperty("user.name”")+ "/rtpMonitor"; 
} 
catch (Securit vException ce) 
username = "RTPMonitor-user"; 


} 


// creates the source description fields 
SourceDescription [] userdesclist = new SourceDescription[3]; 


userdesclist{0] = new 
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SourceDescription( SourceDescription.SOURCE DESC NAME, 
username, 1, false); 
userdesclist{1l] = new 
sourceDescription( SourceDescription.SOURCE DESC CNAME, 
Gname;: (1) “fralse)y 
userdesclist[2] = new 
SourceDescription( SourceDescription.SOURCE DESC TOOL, 
“RrPMonteor vic 0 (4-1 ralse) 


// generates a local address 
SessionAddress localaddr = new SessionAddress(); 


// that is the fraction of RTCP bandwith compared to RTP 
double rtcpFraction = 0.05; 


// if the user has selected for no participation in the session, 
// sets the fraction above to zero ( no RTCP packets ) 
Pot tig ear) 

recprraction = —0..0; 


// initiates the SessionManager object 
mor. Lnitsession () localaddr, <wserdesclist,.rtecprraction.; 0.25 )¢ 


ite tlie eartpml. oetriL(); 


// starts the SessionManager object 
mgr.startSession( sessaddr, ttl, null); 


// if the user has selected for recording statistics, creates a 
// RecordTask objet to generate the reports periodically 
Lit plekecora) | 

recTask = new RecordTask( this, recordInterval ); 


} 


[** 
* Method of classes that implement the ReceiveStreamListener 
* interface 
* 
yf 
public void update( ReceiveStreamEvent event) { 
Player newPlayer = null; 
RtpPlayerWindow playerWindow = null; 
String cname = null; 


SessionManager source = (SessionManager) event.getSource(); 


// if a new stream is received 
if( event instanceof NewReceiveStreamEvent) { 


// gets the ReceiveStream object 
try{ 
ReceiveStream stream = 
( (NewReceiveStreamEvent) event) .getReceiveStream(); 
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// gets the Participant object associated with the stream 
Participant part = stream.getParticipant (); 


// gets the participant canonical name 
Ti{part != nud) 

cname = part.getCNAME (); 
} 


// gets the stream DataSource associated with the stream 
DataSource dsource = stream.getDataSource(); 


// creates a player to play the DataSource 
newPlayer = Manager.createPlayer (dsource) ; 


// if a player was created generates a player window 
if(newPlayer != null) { 
playerWindow = new RtpPlayerWindow( newPlayer, cname) ; 
windowlist.put( stream, playerWindow) ; 


} 
catch (Exception e) { 
System.err.println ( 
"NewRecvStreamEvent exception " + e.getMessage() ); 
return; 


} 


// if the sender of a stream was identified 
if( event instanceof StreamMappedEvent) { 


// gets the ReceiveStream object 
ReceiveStream stream = 
((StreamMappedEvent) event) .getReceiveStream(); 


// gets the Participant associated with the stream 
Participant part = stream.getParticipant(); 


// retrieves the correct player window from the 
// hash table 
if(stream != null) { 
playerWindow = (RtpPlayerWindow) windowlist.get (stream) ; 


} 


// change the title of the player window to include the 

// name of the sender 

if( (playerWindow != null) && (part != null)){ 
playerWindow.Name (part.getCNAME() ); 


} 
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[*~* 
* Closes a monitor session, stops recording and closes player windows 
* 


i 
public void close(){ 


if (flqRecord){ 
recTask.exit(); 


} 
if(flgPlay) { 


Enumeration windows = windowlist.elements(); 
while( windows.hasMoreElements() ) { 
RtpPlayerWindow currwindow = 
(RtpPlayerWindow) windows.nextElement () ; 
LE( currwandow '= null) { 
currwindow. killThePlayer () ; 


} 
} 


mgr.closeSession (null); 
mon = “null; 


/** 
* Returns the RtpMediaLocator associated with the RTP session 
* 


* @return the session media locator 
iy 
public RtpMediaLocator getMedialocator(){ return irtpml;} 


/** ‘ 
* Returns the SessionManager object created by the monitor 
* . 


* @return the SessionManager (RTPSessionMgr) 
“/] 
public SessionManager getSessionManager(){ return mgr; } 


[** 
* Returns the SessionAddress object associated with the RTP session 
* 


* @return the SessionAddress 
i 


public SessionAddress getSessionAddress(){ return sessaddr; } 


} // end of class RtpMonitorManager 
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package org.web3d.vrtp.rtp; 


Vis 

* @(#)RTPPlayerWindow.java 1.7 98/03/28 

* 

* Copyright sig 56-199¢ (by SUne temesystens,slhee:, 

* 901 San Antonio Road, Palio Alto 7s California, 9430s 3.5 a. 

* All rights reserved. 

* 

* This software is the confidential and proprietary information 
* of Sun Microsystems, Inc.” ("Gomeidential intormmasten )-) You 
* shall not disclose such Confidential Information and shall use 
* it only in accordance with the terms of the license agreement 
* you entered into with Sun. 

gee 


import jJavax.media. Player; 
import java.awt.*; 
1imMDOre “COM-SuUn-medilaul.*; 


j 
This class is used to create a window for playing an audio/video 
stream. It is a subclass of PlayerWindow, that added the 
capacity of modifying the window name. 

Both classes were developed by SUN. RTPPlayerWindow came with 
JMF1.1 sample code and PlayerWindow is in the file JMF. jar. 

/, 

public class RtpPlayerWindow extends PlayerWindow { 


+ + + ££ FF F F 


public RtpPlayerWindow(Player player, String title) { 
super (player) ; 
setTitle(title) ; 

} 

public void Name (Sstrrag serele)4 
setTitle(title) ; 

} 


} // end of class PlayerWindow 
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package org.web3d.vrtp.rtp; 


import javax.media.rtp.*; 
impore javax~mediawrtp.event. *? 
import jJavax.medla.rtp.rtcp. *; 


MDOLe javasutil =; 


| bakes 
* A class with some RTP utilities (static methods) 
* 
* @author Francisco Afonso (afonso@cs.nps.navy.mil) 
* @version 1.0 


ay 


Public class Rtepveil 
{ 


* 


/ 


Returns the participant username 
@param part the Participant object 
@return a string with the participant's username 


y 


public static String getUsername (Participant part) { 


+ + + ££ ££ € 


Vector sdeslist = part.getSourceDescription(); 
1f(sdeslist == null) { 
return null; 


} 


SourceDescription des; 


for( int i1=0; ii < sdeslist.size(); +411) { 
des = (SourceDescription) sdeslist.elementAt (ii); 
iE( des. getlype() == Sourcevescription:. SOURCE PESC NAME ™)4{ 


return des.getDescription(); 
} 
} 


reEturn Mild: 
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[** 
* Returns the participant's username or his CNAME, 
if no username is known. 


@param part the Participant object 


+ 


* @return a string with the participant's username or CNAME 
as 
public static String getUsernameOrCNAME (Participant part) { 
String username = getUsername (part); 
if({username == null) { 
return part.getCNAME () ; 
} 


else{ 
return username; 


* 
* Converts an number represented as a signed integer(32 bits) 

* to a long integer (64 bits). JMF methods return the SSRC as an 
* integer. As the SSRC is a 32 bits number, some are represented 
* in JMF as negative integers. 

* This convertion is necessary to present SSRCsS as a positive integer. 
* 


public static long correctSsSRe(m@teng ssrem 4 
it (ssre <<) Op. 
return (4294967296L + ssrc); 
} 


return ssrec; 


} // end of class= kepuUria 


188 


package org.web3d.vrtp.rtp; 


import java.awt.*; 
import java.awt.event.*; 
import jJava- util. *; 
TmpOrt javea.20. ~; 


[** 

* A Dialog to select a session bookmark. It displays a list choice 
* of session names. 

<P> 

* 

* @author Francisco Afonso (afonso@cs.nps.navy.mil) 

* @version 1.0 

* 


>, 


public class SelectBookmark extends Dialog implements ItemListener { 


java.awt.List sessionNamesList; 
Vector sessionAddressVec; 
RtpMonitor theParent; 


[** 
= CONSTIUCTOLE. 
eS 
* @param parent the parent frame 
nf 
public SelectBookmark(Frame parent) { 
super( parent, “Select Bookmark" , true ); 


setSize( 250 , 200 ); 


theParent = (RtpMonitor) parent; 
addWindowListener( new CloseWindow() ); 
sessionNamesList = new java.awt.List( 5 , false); 
loadBookmarks (); 


sessionNamesList.setBackground(Color.lightGray) ; 
sessionNamesList.addIitemListener (this) ; 


add(sessionNamesList) ; 
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[** 
* Activated when a bookmark choice is made. 
* ka Pe 
* @param parent the parent frame 
ay 
public void itemStateChanged( ItemEvent e) { 


int index = sessionNamesList.getSelectedIndex (); 
theParent.sessionText.setText ( 
(String) sessionAddressVec.elementAt (index) i- 
theParent.sessionNameText.setText ( 
sessionNamesList.getItem(index) ); 
setVisible(false); 


[** 
* Loads the session bookmarks from file "bookmarks.txt" 
yd 

private void loadBookmarks () { 


sessionAddressVec = new Vector(); 


ery 4 
BufferedReader input = 
new BufferedReader( new FileReader ("bookmarks.txt") 


String yline, 


while( (line = input.readLine()) != null) { 
int pos = line.lastIndexOf("rtp://"); 
if (pos != -1){ 


sessionAddressVec.addElement( line.substring(pos) ); 
sessionNamesList.add( line.substring( 0, pos ) ); 
} 
} 
IMpue.close (ir: 
} . 
catch ( FileNotFoundException e) { 
System.out.println( "Select Bookmark: " + e.getMessage() ); 
} 
catch ( IOException e) { 
SYStEMeLrT eraneln | 
"Exception reading bookmark: " + e.getMessage() ); 


} 


} // end of class SelectBookmark 
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APPENDIX E. COMPARISON RTP MIB VERSUS JMF STATISTICS 


19] 
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APPENDIX F. RTPHEADER JAVADOC 
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Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 








mil.navy.nps.dis 


Class RtpHeader 


java.lang.Object 
| 
+--mil.navy.nps.dis.PduElement 


| 
+--mil.navy.nps.dis.RtpHeader 





public class RtpHeader 
extends mil.navy.nps.dis.PduElement 


This class encapsulates the header of the Real-time Transport Protocol (RTP) when used to 
transfer DIS packets as a payload. 


Version: 

1.0 
Author: 

Francisco Afonso (afonso@cs.nps.navy.mil) 
References: 


RTP: (RFC1889) http://www. ietf.org/internet-drafts/draft-ietf-avt-rtp-new-04.txt 






Field Summary 


static int}RTP CSRC_ COUNT 
~~ Contains the number of contributing source identifiers in this header. 


static int]RTP EXTENSION 
- The extension bit defines if the normal header will be followed by an 









extension header. 


static inti RTP MARKER 
This bit is used as a marker by a specific profile or application. 
Statice int RTP PADDING PADDING 
_ Padding is being performed at the DIS protocol level. 
static int]RTP PAYLOAD TYPE FOR DIS 
~ The payload type number was set to 111. 
static int}RTP VERSION 
Identifies the version of RTP (2 bits). 
static inti si ze0Of 
Contains the size of the header in bytes (= 12). 
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Constructor Summary 


RtpHeader ( ) 
Constructor. 





Method Summary 


java.lang.Object] clone () 
Makes deep copies of all the instance variables. 





void] deSerialize(java.io.DataInputStream inputStream) 
Fills the header contents with data from a 


DataInputStream 






MLL. navy.nps.util.Unsianedshere getSequenceNumber () 
Returns the packet sequence number. 


mil.navy.nps.util.Unsignedint getSSRC () 
Returns the packet Syncronization Source Identifier. 
mil.navy.nps.util.UnsignediInt getTimestamp () 
Returns the packet timestamp. 
int | length ( ) 
Returns the size of the header. 


vold| prepareToSend 
(mil.navy.nps.dis.ProtocolDataUnit pdu) 


Prepares the header for sending. 















void] printValues(int indentLevel, 
java.io.PrintStream printStream) 


Prints internal values for debugging. 


void} serialize(java.io.DataOutputStream outputStream) 
Serializes the header into a DataOutputStream. 


void! satSequenceNumber 
(mil.navy.nps.util.UnsignedShort pSequenceNumber) 









Sets the packet sequence number. 


void! setSSRC (mil.navy.nps.util.UnsignedInt pSSRC) 
Sets the Syncronization Source Identifier. 





vold| setTimestamp 
(mil.navy.nps.util.UnsignedInt pTimestamp) 


Sets the packet timestamp. 





Methods inherited from class java.lang.Object 


equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
walt, wait 


Field Detail 
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RTP_ VERSION 
publive Static final int REPQVeRSION 


Identifies the version of RTP (2 bits). RFC1889 defines the actual version as two(2). 





RTP PADDING 


public static final int RIP PADDING 


Padding is being performed at the DIS protocol level. Therefore the padding bit is set to 
zero. 





RTP_ EXTENSION 


public static final int RTP_EXTENSION 


The extension bit defines 1f the normal header will be followed by an extension header. 
Not needed in this application, and so set to zero. 





RTP CSRC_COUNT 


public static final int RTP _CSRC_COUNT 


Contains the number of contributing source identifiers in this header. This is used only 
by mixers. Set to zero. 





RTP MARKER 


public static final int RTP_MARKER 


This bit is used as a marker by a specific profile or application. Not used so far. Set to 
Zero. 





RTP PAYLOAD TYPE FOR DIS 


_ public static final int RTP_PAYLOAD_TYPE_FOR_DIS 


The payload type number was set to 111. It belongs to the dynamic assignment range 
(96-127). Numbers in this range do not need to be registered. 
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See: http://www. ietf.org/internet-drafts/draft-ietf-avt-profile-new-06.txt - Session 3. 





sizeOf 
PUbDlLIC Stat Cc tinal Ine, si Ze0c 


Contains the size of the header in bytes (= 12). 


Constructor Detail 


RtpHeader 


public RtpHeader () 


Constructor. An empty header is created. 


Method Detail 


getSequenceNumber 
public mil.navy.nps.util.UnsignedShort getSequenceNumber () 
Returns the packet sequence number. 


Returns: 
the sequence number as an unsigned short (16 bits) 





getTimestamp 


public mil.navy-.nps.util.UnsignedInt getTimestamp ( ) 
Returns the packet timestamp. 


Returns: 
the timestamp as an unsigned int (32 bits) 


getSSRC 


public mil.navy.nps.util.Unsignedint getSSRC() 


Returns the packet Syncronization Source Identifier. 
Returns: 
the SSRC as an unsigned int (32 bits) 
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setSequenceNumber 
public void setSequenceNumber (mil.navy.nps.util.UnsignedShort pSequenceNumber 
Sets the packet sequence number. 


Parameters: 
pSequenceNumber - the sequence number as an unsigned short (16 bits) 





setTimestamp 
public void setTimestamp(mil.navy.nps.util.Unsignedint pTimestamp) 


Sets the packet timestamp. 
Parameters: 
pTimestamp - the timestamp as an unsigned int (32 bits) 





setSSRC 


public void setSSRE (mil navy .npssvb1l. Unsreanedint pSsRe) 


Sets the Syncronization Source Identifier. 
Parameters: 
pssrc - the SSRC as a unsigned int (32 bits) 





prepare ToSend 
public void prepareToSend(mil.navy.nps.dis.ProtocolDataUnit pdu) 


Prepares the header for sending. Assigns the sequencial number from a static variable, 
takes the timestamp from the DIS pdu and sets the SSRC. 
Parameters: 

pdu - the DIS pdu that will be transmitted 


length 


Public int length) 


Returns the size of the header. 
Overrides: 

length in class mil.navy.nps.dis.PduElement 
Returns: 

the header size 
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serialize 
public void serialize(java.io.DataOutputStream outputStream) 


Serializes the header into a DataOutputStream. 
Overrides: 
serialize in class mil.navy.nps.dis.PduElement 
Parameters: 
outputStream - the stream that will receive the serialized header. 


deSerialize 


public void deSerialize(java.io.DataInputStream inputStream) 


Fills the header contents with data from a DataInputStream 
Overrides: 

deSerialize in class mil.navy.nps.dis.PduElement 
Parameters: 

inputStream - the stream which contains the header. 





clone 


public java.lang.Object clone() 


Makes deep copies of all the instance variables. 
Overrides: 
clone in class mil.navy.nps.dis.PduElement 


printValues 


public void printValues(int indentLevel, 
java.io.PrintStream printStream) 


Prints internal values for debugging. 
Overrides: 
printValues in class mil.navy.nps.dis.PduElement 


Class Tree Deprecated Index Help 


PREV CLASS NEXT CLASS FRAMES NO FRAMES 
SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
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APPENDIX G. RTPHEADER SOURCE CODE 


package mil.navy.nps.dis; 


iReGELeMI shavyonps.Ucil 7; 
Import qgava.1O. "7 


‘ 


+ + + £ £ F F F F € OF € OF 


+ 


™ 


This class encapsulates the header of the Real-time Transport Protocol (RTP) 
when used to transfer DIS packets as a payload. 


@version 1.0 
@author Francisco Afonso (afonso@cs.nps.navy.mil) 


<dt><b>References: </b> 

<dd>RTP: (RFC1889) <a href="http://www.ietf.org/internet-drafts/draft-ietf- 
ave=rep—-new—04.txt"> 

http: //www.ietf.org/internet-drafts/draft-ietf-avt-rtp-new-04.txt</a> 


public class RtpHeader extends PduElement 


{ 


// this SSRC will be used for all transmitted packets 
private static long mySSRC; 


// this variable contains the next sequence number of a transmitted packet 
private static int nextSequenceNumber; 


Static 


{ 


// assigns a random integer to the SSRC 


mYooORC -=' (long) { Math. random() ~"Unsrgmedint.MAX INT VALUE”); 
// assign a random integer to the first sequence number 
nextSequenceNumber = (int) (Math.random() *UnsignedShort .MAX SHORT VALUE ); 
} 
[** 


* Identifies the version of RTP (2 bits). RFC1889 defines the actual 


* version as two(2). 
* 


ae 
Public Stactic final int RIP VERSION = 2, 


207 


[** 
* Padding is being performed at the DIS protocol level. 
* Therefore the padding bit is set to zero. 
* 
ae 
public Statac final intel ieee. wr Ne — 0; 


[** 
* The extension bit defines if the normal header will be followed 
* by an extension header. 
* Not needed in this application, and so set to zero. 
* 
ard 
public static final ant RIPSEXTE Sie — eC, 


fue 
* Contains the number of contributing source identifiers in this header. 
* This is used only by mixers. Set to zero. 
* 
ad 
public static final int RIP CSRE COUNT — 0; 


[** 
* This bit is used as a marker by a specific profile or 
77 application. 
* Not. used»so far. Set to Zero. 
* 
mer 
public static final int RTP MARKER = 0; 


[** 

* The payload type number was set to 1l1l. 

* It belongs to the dynamic assignment range (96-127). 

* Numbers in this range do not need to be registered. <p> 

* See: <a href="http://www.ietf.org/internet-drafts/draft-ietf-avt-profile- 
* New-Car xe 

* http: //www.ietf.org/internet-drafts/draft-ietf-avt-profile-new-06.txt</a> 
x Sessoms. 

* 

* 

* 


= 


public static final int RTP PAYLOAD TYPE FOR DIS = 111; 
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| aac: 
* Contains the size of the header in bytes (= 
wie: 


public static final int sizeOf = 12; 


// the packet sequence number 
private UnsignedShort sequenceNumber; 


// the packet timestamp 
private UnsignedInt timestamp; 


// the packet Sincronization Source Identifier 
private UnsignedIint Sone; 


jx* 
* Constructor. An empty header is created. 
ie | 
public RtpHeader () 
{ 
sequenceNumber = new UnsignedShort(); 
timestamp = new UnsignediInt(); 
SSRC = new UnsignedInt(); 


return; 


Vise 


* Returns the packet sequence number. 


Ba Oe 


(SSRC) 


*  @return the sequence number as an unsigned short (16 bits) 


eye 
public UnsignedShort getSequenceNumber () 
{ 


return (UnsignedShort) sequenceNumber.clone(); 


} 


| hs 


* Returns the packet timestamp. 


* G€@return the timestamp as an unsigned int (32 bits) 


a 
public UnsignediInt getTimestamp() 
{ 


return (Unsignedint)timestamp.clone(); 


} 


[** 


* Returns the packet Syncronization Source Identifier. 
* @return the SSRC as an unsigned int (32 bits) 


as 
public UnsignedInt getSSRC() 


{ 
return (UnsignediInc) SSRC.clone(); 


} 
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[** 


* 
*” 


* 


me 


Sets the packet sequence number. 
@param pSequenceNumber the sequence number as an unsigned short 
(Te sibases)) 


public void setSequenceNumber (UnsignedShort pSequenceNumber) 


{ 
} 


[** 


* 


* 


a7 


sequenceNumber = pSequenceNumber; 


Sets the packet timestamp. 
@param pTimestamp the timestamp as an unsigned int (32 bits) 


public void setTimestamp(UnsignedInt pTimestamp) 


{ 


[** 


* 


* 


ae 


timestamp = pTimestamp; 


Sets the Syneroni zation, Source bdentitier. 
@param pSSRC the SSRC as a unsigned int (32 bits) 


public void setSSRC(UnsignedInt pSSRC} 


{ 


ei 
pra 


{ 


SSRC = pSSRC; 


Increments the sequence number. The RtpHeader class mantains a static 


variable with the next sequence number to be assigned to a packet. 
This function increments this variable. If the sequence number will 
exceed the 32 bits boundaries it is set to Zero. 


vate void incrementSequenceNumber () 


// if after the increment the sequence number gets longer than 16 
bits 
// than it should be set to zero 
++nextSequenceNumber; 
if( nextSequenceNumber > UnsignedShort.MAX SHORT VALUE ) { 
nextSequenceNumber = Q; 


} 


return. 
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fx* 

* Prepares the header for sending. Assigns the sequencial number from 

* a static variable, takes the timestamp from the DIS pdu and sets the SSRC. 
* @param pdu the DIS pdu that will be transmitted 

ey 

public void prepareToSend( ProtocolDataUnit pdu ) 

{ 


// assigns a sequence number (the next sequence number kept by a 
static 

// variable) 

sequenceNumber = new UnsignedShort( nextSequenceNumber ); 


// increments the next sequence number variable 
incrementSequenceNumber () ; 


// assigns as a timestamp the Dis-Java-Vrml timestamp 
timestamp = pdu.getTimestamp(); 


// assigns the common SSRC 
SSRC = new UnsignediInt( mySSRC ); 


return? 


[r* 

* Returns the size of the header. 
* @return the header size 

airs 

public int -Lenath () 

{ 


return RtpHeader.sizeOf; 


} 


/ mk 
* Serializes the header into a DataOutputStream. 
* @param outputStream the stream that will receive the serialized header. 
aes 
public void serialize(DataOutputStream outputStream) 
{ 
// creates the first and second byte from the header 
UnsignedByte firstByte = new UnsignedByte( (RTP VERSION * 64) + 
(RIP OPADDING.* 320+ (REPLEATenorON, ~ 116) RIEPSCSRC COUNT ); 
UnsignedByte secondByte = new UnsignedByte( (RTP MARKER * 128 ) 
+ RTP PAYLOAD TYPE FOR DIS ); 


// serializes 
firstByte.serialize(outputStream) ; 
secondByte.serialize(outputStream) ; 
sequenceNumber. serialize (outputStream) ; 
timestamp.serialize(outputStream) ; 
SSRC. serialize (outputStream) ; 

return; 
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7 
* Fills the header contents with data from a DatainputStream 
* @param inputStream the stream which contains the header. 
ne 
public void deSerialize(DataInputStream inputStream) 
{ 

UnsignedByte firstByte = new UnsignedByte(0Q); 

UnsignedByte secondByte = new UnsignedByte (0); 


// deserializes 
firstByte.deSerialize(inputStream) ; 
secondByte.deSerialize(inputStream) ; 
sequenceNumber.deSerialize(inputStream) ; 
timestamp.deSerialize (inputStream) ; 
SSRC.deSerialize (inputStream) ; 


meciuiren:, 


[** 

* Makes deep copies of all the instance variables. 
*“ 

rey, 

public Object clone() 

{ 


RtpHeader newHeader = (RtpHeader) super.clone()j; 


newHeader.setSequenceNumber (this.getSequenceNumber () ) ; 
newHeader.setTimestamp(this.getTimestamp()); 
newHeader.setSSRC (this.getSSRC()); 


return newHeader; 


} 


[** 
* Prints internal values for debugging. 
n ; 


oe 
public void printValues(int indentLevel, PrintStream printStream) 
{ 
StringBuffer buf = 
ProtocolDataUnit.getPaddingOfLength(indentLevel) ; 


printStream.println(buf + "sequenceNumber: " + 
sequenceNumber.intValue()); 

printStream.println(buf + "timestamp: " + timestamp.longValue()); 

printStream.printin(but + “SSRC: “ + SSR. fengVvalue ar, 

return, 


} 


} // end of class RtpHeader 


we 
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